网页或移动应用需要上传图片、附件时,可以让客户端直接把文件传到阿里云OSS。PostObject采用HTTP表单上传,文件不必先经过业务服务器中转,能减少服务器的带宽和处理压力。配置时要把表单字段、服务端签名和上传策略配对好;AccessKey等长期密钥不能放进前端。
阿里云PostObject是什么
PostObject是阿里云对象存储OSS提供的表单上传接口。客户端向Bucket对应的上传地址发送multipart/form-data请求,在表单中提交文件、目标对象名称和授权信息。OSS校验请求后,会把文件保存为指定的Object。
PutObject和PostObject都能上传对象,区别在于请求格式:PutObject通常将文件作为请求体发送,PostObject则使用HTML表单格式,并可通过Policy限制上传条件。浏览器直传、限制文件大小或限定上传目录时,PostObject的配置方式比较直观。如果项目已经使用OSS SDK,也可以先确认SDK支持哪些上传方式,再结合客户端类型和业务限制做选择。
一次上传需要哪些环节
- 客户端申请上传凭证:用户选好文件后,前端向业务服务端请求上传参数。服务端先确认用户身份和上传权限,再决定是否签发凭证。
- 服务端生成授权信息:服务端根据Bucket、对象名称规则、有效期和文件限制生成Policy及签名;需要时,也可以使用STS临时凭证。
- 客户端提交表单:前端将授权字段和文件组成multipart/form-data请求,发送到Bucket所在地域对应的OSS地址。
- OSS校验并保存:OSS检查签名和Policy条件。上传成功后,业务端再按需要记录对象名称等信息。
Policy通常要经过Base64编码,内容可以包括上传约束,例如要求对象名以指定目录前缀开头、限制文件大小范围,或限定请求的有效时间。签名由服务端生成,并且必须与Policy和凭证相匹配。不同签名版本需要的字段可能不同,实际开发时应按阿里云当前文档和所用SDK生成,不要把某个示例中的字段直接套到所有项目里。
案例:活动图片由浏览器直传OSS
假设活动平台允许主办方上传海报。如果文件先传到业务服务器,再由服务器转存OSS,业务服务器就要承担额外的流量和处理工作。改用PostObject后,前端先请求业务接口;服务端检查主办方是否有该活动的管理权限,并生成短时授权;前端再把图片直接提交给OSS。上传成功后,前端将对象名称交给业务接口,写入活动记录。
服务端可以把对象名称限制在events/活动编号/目录下,并设置合适的最大文件尺寸。这样,即使用户修改前端参数,也不能凭这次授权把文件传到任意目录。若系统需要确认文件确实对应某个活动,还要由业务服务端核验用户权限和对象路径,不能只根据浏览器提交的文件名判断。
配置时容易忽略的细节
长期密钥不能放到前端
网页代码可以被查看,应用包也可能被提取。把AccessKey Secret等长期密钥写进前端,存在泄露风险。应由服务端签发短时、权限受限的授权,或使用STS临时凭证。Policy有效期尽量短,授权范围也应按实际需求收紧。
谨慎处理用户文件名和对象名称
用户文件名可能重复,也可能带有空格、特殊符号或不适合URL处理的字符。通常由服务端生成唯一Object Key,例如加入随机标识,并保留经过校验的扩展名。还要提前确定是否允许覆盖同名对象,避免上传时替换已有文件。
核对地域、字段和文件限制
上传地址要与Bucket所在地域匹配,签名、Policy、对象名和实际请求字段也要一致。表单字段的排列顺序通常不是重点,但字段名称和值必须正确,文件字段也不能漏掉。配置了content-length-range时,要确认范围符合业务允许的文件大小;服务端还应检查文件类型及后续处理规则。只看扩展名,无法确认文件的真实内容。
确认OSS上传成功后的业务状态
OSS返回成功,只能说明对象已上传,不能说明数据库记录已更新、图片已审核,或文件已经可以安全访问。建议把上传状态和业务记录关联起来,并考虑失败重试及未完成对象清理。使用OSS回调时,也要在服务端验证回调请求,不能直接把未经验证的内容当作可信业务数据。
常见问题怎么排查
遇到403错误,先核对签名字段、Policy编码、有效期、凭证权限和Bucket地域。出现文件大小相关错误时,检查Policy中的大小范围以及实际请求体大小。浏览器提示跨域问题,则查看OSS控制台的CORS规则是否允许当前来源、请求方法和所需响应头。排查时尽量查看OSS返回的错误码和响应内容,前端的“上传失败”提示往往不够具体。
阿里云PostObject适合需要客户端直传OSS,同时又要控制目录、有效期和文件大小的应用。把签名留在可信的服务端,上传后再完成业务校验,能减少服务器的文件传输负担,也避免把权限直接交给前端。