商品后台、内容发布页和资料归档系统,经常需要一次上传多张图片。若文件先发到业务服务器,再由服务器转存到对象存储,图片流量会占用应用服务器带宽和处理资源,网络状况不好时,页面等待也会更明显。
阿里云OSS多图上传通常采用客户端直传:前端向业务后端申请临时凭证,再把文件直接上传到OSS。这样能减少业务服务器承担的文件传输工作,但上传流程仍要处理授权范围、并发数量、进度反馈和失败恢复。只把文件循环提交出去,遇到部分失败或业务记录未保存时,问题仍然会落到用户和开发人员头上。
先把上传链路设计清楚
一条常见链路是:用户选择文件,前端做基础校验,业务后端验证用户权限并签发临时凭证,前端使用凭证上传文件,随后把成功文件的信息交给业务接口保存。图片数据不经过业务服务器,后端负责权限校验、生成或确认对象路径、签发短期授权,并维护对应的业务记录。
临时凭证可以通过阿里云STS等方式获取。授权范围应限制到指定Bucket或对象前缀,并设置较短的有效期。AccessKey等长期密钥不能放进网页代码或移动端安装包;即使代码经过压缩,也不能把客户端当作可信的密钥存放位置。
还要分清“文件上传成功”和“业务保存成功”。前者表示对象已写入OSS,后者表示业务系统已经确认这张图片属于当前用户和对应业务。两步之间若缺少核验,页面可能显示上传完成,商品记录里却没有图片。
多图上传的实现步骤
1. 选择文件后先校验
上传前检查文件数量、单张大小和允许的格式。图片类型可以同时参考文件扩展名与浏览器提供的MIME类型;对安全要求较高的业务,还应由服务端检查实际文件内容。文件名和MIME类型都可能由用户控制,不能单独作为安全判断依据。
遇到超出限制的文件,建议只标记并提示对应文件,不要让一张不合规图片阻塞整批任务。前端可把每个文件整理成独立任务,记录文件名、大小、状态、进度和OSS对象路径,方便后续展示、重试和排查。
对象路径不要直接采用用户上传的文件名。可以按业务类型、日期和随机标识组织路径,并由服务端生成或校验。这样能降低文件重名覆盖的风险,也避免把用户提交的特殊字符直接带入对象路径。
2. 获取临时授权,再发起上传
用户开始上传时,前端向业务后端申请临时凭证。后端先确认用户是否有权修改当前商品或提交当前内容,再返回必要的授权信息和上传配置。前端使用对应的OSS SDK初始化上传任务,并逐项维护“等待中、上传中、成功、失败”等状态。具体接口会受开发语言、SDK版本和上传方式影响,接入时应核对对应版本的阿里云官方文档。
普通小文件通常可以使用简单上传;文件较大或网络不稳定时,可以考虑分片上传。分片上传把单个文件拆成多个部分传输,部分分片失败时可重试,适合处理较大的文件。它和多图并发解决的是两类问题:前者针对单个大文件,后者针对多个文件同时上传。两种方式可以组合使用,但需要控制总并发,不能把所有图片和分片都无限制地同时发出。
3. 控制并发并把进度说清楚
可以先设置有限的并发池,例如同时上传3至5张图片,完成一张后再加入下一张。这个范围只是起点,实际数量应结合文件大小、用户网络和服务端配置测试。并发过高会争抢用户带宽,也可能增加失败率;在移动设备上,还会带来额外的耗电和发热。
进度信息最好同时显示单文件状态和整批进度。单文件进度方便用户找到卡住或失败的任务;整批进度则适合概览当前上传情况。若要计算整批进度,应按文件总字节数加权,而不是把每张图片的百分比简单平均。比如一张大图上传了50%,另一张小图上传完成,平均百分比并不能准确反映已传输的数据量。
商品后台批量上图的处理方式
以电商运营后台为例,运营人员可能一次给一个商品上传十几张图片,期间还会遇到网络波动。若浏览器先把图片提交到应用服务器,再由服务器转存OSS,等待时间会变长;传输中断后,如果只能整批重来,已成功的图片也要重复上传。
改造时,后端先校验商品编辑权限,并签发只允许写入该商品临时目录的短期凭证。前端将图片拆成独立任务,最多同时上传4张。每张图片成功后,记录对象路径和必要的文件信息;失败任务可以单独重试,不影响已经完成的图片。
所有任务结束后,前端把成功对象列表提交给业务接口。后端再次核验对象路径是否属于当前商品、对象状态是否正常,以及用户是否仍有相应权限,确认后再写入商品图片记录。这样,文件传输和业务入库各自有明确的状态,也更容易定位问题发生在哪个环节。
容易漏掉的安全与稳定性问题
- 临时授权范围过宽:不要向客户端提供可写整个Bucket的长期凭证。应限制对象范围和有效期,并只授予当前上传所需的权限。
- 跨域规则配置不匹配:浏览器直传OSS需要配置跨域规则,包括来源、请求方法和必要请求头。跨域配置只影响浏览器能否发起请求,不负责验证用户身份,也不能代替授权。
- 重复上传导致覆盖:为每次上传生成唯一对象名。若业务需要替换图片,应由后端明确处理新旧对象及数据库引用,避免误删或覆盖仍在使用的文件。
- 失败后无限重试:网络错误可以设置有限次数的退避重试,并保留失败原因。授权过期、格式不符等错误通常需要重新获取凭证或更换文件,反复重试不会解决问题。
- 上传后没有业务核验:后端应确认对象属于当前用户和对应业务目录;必要时再检查文件大小、类型或内容,通过后才写入正式记录。
上线前检查这些场景
测试时不要只用几张小图验证成功路径。应覆盖不同文件数量和大小、网络波动、用户取消、页面刷新、凭证过期、部分失败及重复提交等情况,并确认失败任务不会误删已成功文件。若页面刷新后不支持恢复进度,也要明确告知用户哪些文件需要重新上传。
还需确定临时文件的清理方式。用户取消上传或业务保存失败后,未被正式记录引用的对象可以通过定时任务清理;清理时应根据业务状态判断,避免把仍在处理中的文件提前删除。上线后保留必要的上传状态和错误信息,遇到问题时才能区分授权失败、网络中断和业务入库失败。
把临时授权、有限并发、逐项反馈、失败重试和上传后核验分别处理,阿里云OSS多图上传就更容易适应真实网络环境。应用服务器也不必承担图片转存流量,业务侧则能保留对文件归属和最终入库的控制。