图片、视频和附件如果都放在业务服务器上,文件增长后,磁盘空间、备份和带宽都会成为维护负担。阿里云对象存储 OSS 可以单独保存这类文件,并通过接口完成上传、下载和管理。接入时,除了让文件“传得上去”,还要提前想好谁能上传、谁能访问,以及上传失败后怎么处理。
开始开发前,先理清 OSS 的基本概念
OSS 的存储空间叫 Bucket,文件以 Object 的形式保存在其中。一个 Object 通常包含文件内容、对象名称和元数据。对象名称可以按业务规划,例如 avatars/user-1024.png 或 orders/2025/08/invoice-001.pdf。不过,OSS 不是传统文件系统:斜杠只是对象名称的一部分,控制台会把它显示成类似目录的结构。
接入前要确定地域、Bucket 名称、访问权限和文件访问方式。地域可以结合业务服务器和用户分布来选,减少不必要的网络延迟;Bucket 名称则需符合阿里云的命名规则。测试环境和生产环境最好使用不同 Bucket,或至少通过清晰的前缀隔离。这样能降低测试脚本误删、覆盖线上文件的风险。
按业务选择文件上传方式
服务端上传:权限集中,流程容易管理
服务端上传时,客户端先把文件发给业务服务器,再由服务器调用 OSS SDK 写入 Bucket。服务器可以在上传前检查用户身份、文件格式和业务条件,也方便记录上传结果。文件量不大、流程简单的项目,可以先采用这种方式。
它的代价也很直接:所有文件都经过业务服务器。图片和附件不多时通常容易管理;如果大文件上传和高并发请求持续增加,服务器带宽和处理能力可能成为瓶颈。
客户端直传:减少业务服务器的传输压力
文件较多时,可以让业务服务器先验证用户身份,再生成短时有效的临时凭证,或签发权限受限的预签名 URL。浏览器或移动端拿到授权后,直接把文件上传到 OSS,业务服务器不必代收文件内容。
客户端不能保存长期有效的 AccessKey,也不能把云账号密钥写进前端代码。临时授权应限制可访问的 Bucket、对象范围、有效时间和允许的操作,并由服务端按业务需要签发。使用哪种 SDK、如何初始化,会随编程语言和 SDK 版本变化;接入时应核对阿里云官方文档和对应示例。实际流程通常包括配置地域与凭证、确定 Bucket、生成对象名称、上传文件、处理结果,再把业务需要的对象信息写入数据库。
以电商头像上传为例
用户更换头像时,客户端先向业务接口申请上传权限。服务端确认用户身份后,生成限定对象路径和短时有效的授权;客户端随后直接上传图片。上传完成后,客户端通知业务服务,服务端记录对象名称和头像更新时间。页面展示头像时,再根据访问策略提供可用地址。
对象名称不要直接沿用用户提交的原始文件名,避免重名、特殊字符或路径混乱。可以将用户编号与随机字符串、文件扩展名组合,例如 avatars/1024/a8f3c2.jpg。服务端还应检查文件大小、类型和用户权限,不能只相信浏览器传来的文件名或 Content-Type。头像会公开展示时,也要确认内容符合平台规范。
头像只供登录用户查看,可以使用私有 Bucket,由服务端生成有时效的签名访问地址;如果允许公开查看,则可以配置合适的读取策略或自定义域名。开放读取不等于开放上传,读权限和写权限要分别设置。数据库适合保存对象名称等稳定标识,不要把有有效期的签名 URL 当作永久地址。
生产环境容易漏掉的配置
- 按需授权:给应用使用的身份只授予业务必需的权限,避免直接使用权限过大的主账号密钥。
- 妥善保存凭证:长期凭证放在服务端安全配置或密钥管理方案中,不提交到代码仓库,也不要打包进前端页面和客户端安装包。
- 处理大文件:文件较大时评估分片上传,并考虑暂停、重试和断点续传;未完成的分片也要有清理安排。
- 正确配置跨域:浏览器直传时,按实际网站域名、请求方法和请求头设置跨域规则。跨域配置只解决浏览器通信限制,不能代替身份认证。
- 区分读取与上传:根据文件是否公开选择访问策略。用户隐私或业务资料不应因为方便访问,就把 Bucket 设置为公共读。
- 准备失败处理:上传失败后记录必要的错误信息,并提供重试方式。日志中不要暴露密钥、完整隐私内容或敏感访问地址。
上线后关注维护与成本
OSS 费用通常与存储、请求和数据传输等因素有关,具体计费应以阿里云当前产品说明为准。测试数据可以设置清理规则;生产环境则可根据访问频率和文件保留要求,评估生命周期管理、分层存储或过期删除策略。删除规则上线前,先核对对象范围,避免清掉仍被业务引用的文件。
日常维护时,可以关注上传失败率、请求错误和流量变化。图片等内容读取频繁时,可以评估接入 CDN,同时考虑缓存刷新、URL 有效期和源站访问控制。需要追溯文件处理过程的业务,还应在应用侧记录上传时间、用户标识、对象名称和处理状态,不能只依赖 OSS 中的文件来管理业务流程。
阿里云开发 OSS 时,可以让 OSS 负责保存对象,让业务系统负责身份验证、权限判断和数据关联。小型项目可先从服务端上传开始;文件量增加后,再评估客户端直传、临时授权和分片上传。上线前把权限边界、对象命名和异常处理逐项检查清楚,后续再按业务需要增加 CDN 或生命周期规则,会更容易维护。