图片上传如果先经过业务服务器,再由服务器转存到阿里云 OSS,服务器就要多承担一段文件流量和转发工作。图片数量或体积上来后,这部分带宽和处理压力也会增加。常见的替代方式是浏览器直接上传到 OSS,业务服务器负责验证用户、发放临时凭证,并保存图片与业务数据之间的关系。
前端上传图片到阿里云,重点不只是让文件成功到达 Bucket,还要把凭证权限、跨域、对象命名和失败处理一起考虑。尤其要记住:浏览器端不能保存阿里云账号的长期 AccessKey。
先理清上传链路
比较稳妥的流程是:用户选择图片后,前端向业务后端申请临时上传凭证;后端检查用户身份和操作权限,再通过阿里云 STS 获取短期授权;前端拿到临时凭证后,把文件直接上传到 OSS;上传成功后,再将对象名称提交给业务后端保存。
文件绕过业务服务器,能减少服务器接收和转发图片的工作。后端仍然掌握授权入口,可以决定哪些用户能上传、允许写入哪个目录,以及凭证何时失效。需要区分的是,直传只改变文件传输路径,并不会自动完成业务校验或图片访问权限管理。
后端先准备好临时授权
在阿里云侧创建 RAM 角色,并按实际需求配置权限。例如,角色只允许向指定 Bucket 的指定目录写入对象,不要为了省事给出超出上传所需的权限。业务后端在确认用户身份后调用 STS,获取临时 AccessKeyId、AccessKeySecret 和 SecurityToken,再把临时凭证交给前端。
长期 AccessKey 应保存在服务端,不能写进网页源码、前端配置文件,也不能提交到公开代码仓库。前端代码会发送到用户浏览器,使用者可以查看其中的内容;把密钥藏在变量名或压缩后的脚本里,并不能解决暴露问题。
STS 凭证应设置合理的有效期,权限也要限制在当前上传任务需要的范围内。后端还可以为文件生成带随机标识的对象名称,避免不同用户上传同名文件时互相覆盖。凭证过期后,前端应重新向后端申请,而不是尝试继续使用失效凭证。
前端直传的基本做法
前端可使用阿里云 OSS 的 JavaScript SDK。用户选择文件后,先调用业务接口获取临时凭证,再用凭证和 Bucket 等配置初始化 OSS 客户端,最后调用 put 上传文件。整体顺序可以概括为:读取所选文件、申请授权、创建客户端、上传对象、把上传结果提交给业务后端。
初始化客户端时通常需要 region、bucket 和临时凭证字段。对象名称(objectName)是文件在 OSS 中的路径,例如 images/2025/随机文件名.jpg。示例中的年份只是路径组织方式,项目可以按自己的目录规则设置。不要把用户提供的原始文件名直接当作唯一对象名:多人可能上传同名文件,文件名还可能带有空格或特殊字符。更稳妥的做法是使用随机 ID,并对扩展名进行校验。
上传成功后,前端可以读取结果中的 URL 或对象名称,但建议把对象名称交给业务后端保存,由后端关联用户和具体业务记录。这样以后更换图片域名或调整访问方式时,不必在多张业务表里逐一修改完整 URL。若 Bucket 设置为私有读,展示图片时需要由服务端按需生成带有效期的访问地址,不能默认上传成功就代表图片可以公开访问。
商品图片上传时怎么走
以商城后台上传商品主图为例,运营人员选好图片后,前端可以先检查文件格式和大小,例如只接受 JPEG、PNG、WebP,并限制在 5MB 以内。检查通过后,前端请求获取上传授权的接口。后端确认用户已登录且有相应操作权限,再返回短期 STS 凭证和建议的对象路径。
图片随后由浏览器直传 OSS。成功后,前端把对象名称提交给商品保存接口,业务记录保存对象名称或统一的图片标识。前端校验主要用于尽早提示用户,真正的授权和限制仍要由服务端及 OSS 相关配置配合完成。否则,用户绕过页面检查直接构造请求时,前端的格式和大小限制就起不到保护作用。
容易遗漏的配置和处理
- OSS 跨域:在 Bucket 跨域设置中,按业务网站配置允许的来源、PUT 等请求方法和必要请求头。配置不匹配时,浏览器会拦截请求;即使临时凭证有效,上传也可能无法完成。排查时应同时检查浏览器控制台和网络请求。
- 文件校验:前端校验能及时给出反馈,但不能代替权限控制。授权范围应限制可写入目录,服务端接口或上传流程也应落实类型、大小等要求。扩展名只是文件名的一部分,不能单独证明文件内容安全。
- 进度与失败提示:可以使用 SDK 的上传进度回调显示百分比,并区分网络中断、凭证过期和权限不足等情况。遇到凭证过期,可重新申请后再按业务需要重试;不要把所有错误都提示成“上传失败”。
- 大文件上传:普通图片通常可以直接上传。文件较大或网络不稳定时,可考虑分片上传和断点续传,但相关流程更复杂,还需要考虑未完成分片的清理方式,按项目需求和 SDK 能力选择即可。
- 图片访问:文件上传成功,不等于页面一定能正常显示。还要确认 Bucket 的读权限、对象地址、CDN 域名和 HTTPS 配置是否符合预期。私有读的图片不能直接按公开地址使用。
上线前检查这几项
发布前用测试账号走一遍完整流程:未登录用户是否拿不到凭证;凭证过期后页面能否提示并重新申请;同名文件是否会覆盖;不支持的格式和超大文件是否会被拦截;网络中断后用户是否知道该怎么处理。浏览器网络面板也值得检查一遍,确认请求中没有出现长期 AccessKey。
前端上传图片到阿里云,可以让浏览器负责传文件,让后端负责身份验证和授权。临时凭证、最小权限、对象命名和跨域配置都处理好后,直传 OSS 能减少业务服务器的转发负担,也更方便后续调整图片访问方式。为了少写一段后端代码而把长期密钥放进页面,风险远大于这点便利。