开发图片、文档或音视频上传功能时,搜索“阿里云文件上传接口”会发现它并不是单独的一个接口。文件可以先传到业务服务器,再由服务器写入 OSS;也可以由浏览器或 App 直接上传到 OSS。大文件还可以使用分片上传。
选哪种方式,主要看文件由谁传、授权怎么发放,以及上传完成后怎样确认文件可用。选得不合适,文件经过业务服务器会增加带宽和处理压力;凭证管理不严,则可能让存储资源被滥用。
4种常见上传方式
1. 业务服务器接收文件后上传 OSS
客户端先把文件发送到业务服务器,服务器完成校验后,通过 OSS SDK 上传。这种方式便于集中处理用户权限、文件类型检查和业务记录,适合文件较小、上传量不高,或上传前必须经过严格审核的场景。
代价是文件要经过业务服务器,网络流量、处理时间和临时存储压力都会增加。文件较大或并发较高时,要留意服务器带宽、请求超时和内存占用。尤其要避免一次把整个文件读入内存,否则并发上传时容易放大资源消耗。
2. 浏览器或 App 使用临时凭证直传
客户端先向业务后端申请临时授权。后端验证用户身份和上传权限后,通过阿里云 STS 等机制签发权限受限、短时有效的凭证;客户端再使用 OSS SDK,将文件直接传到指定 Bucket。文件内容不经过业务服务器,能减少服务器承担的传输流量。
图片、附件和移动端上传常用这种方案。临时凭证应限制有效时间、Bucket 和可执行的操作,必要时也要限制对象前缀。不要把 AccessKey ID、AccessKey Secret 等长期密钥放进网页代码或 App 安装包。
3. 服务端签名,客户端直接上传
后端也可以生成预签名 URL 或签名信息,客户端在有效期内使用它上传指定对象。这种方式同样能绕过业务服务器传输文件,适合希望减少客户端授权处理、又不需要服务器代收文件的应用。
签名应与对象路径、请求方法和有效时间对应。实现时要检查签名是否会被重复使用或滥用,并确保客户端拿到的授权范围只覆盖本次上传所需的对象和操作。
4. 大文件分片上传
上传视频、压缩包等大文件时,可以使用 OSS 分片上传:先初始化上传任务,再逐片上传,最后完成合并。网络中断后,客户端可以重试未完成的分片,避免从头再传。
分片上传需要额外处理任务状态、失败重试和过期任务清理。接入前要确认所用 OSS SDK 是否支持断点续传,并核对浏览器、移动端或服务端对应版本的实现要求。文件不大、网络稳定时,普通上传往往更省事。
一次上传请求如何走完
-
客户端申请上传权限。调用业务接口时带上登录态、文件名、文件大小和必要的业务标识。文件名可以用于展示,但不能单凭客户端传来的名字判断用户身份或文件归属。
-
后端校验并生成授权。检查用户是否有权上传、文件大小是否符合限制、文件类型是否允许,以及是否超出业务配额。通过后生成唯一对象路径,例如按用户编号和日期分层存放,再返回短期凭证或签名信息。长期密钥不应返回给客户端。
-
客户端上传到 OSS。根据文件大小选择普通上传或分片上传。配置进度回调、失败重试和取消操作,用户才能判断当前进度,也能在网络异常时采取相应操作。
-
后端确认上传结果。上传完成后,客户端把对象路径、文件大小等信息提交给业务后端。后端核验对象是否存在、是否属于当前用户,再写入业务数据库。需要更可靠的确认时,可以结合 OSS 回调或服务端查询;不要只依据客户端提示的“上传成功”就认定业务处理完成。
案例:企业知识库上传 PDF 附件
假设企业知识库允许员工给文章添加 PDF。若所有文件都先传到应用服务器再转存 OSS,日常少量上传可能没有明显问题;遇到集中导入资料,服务器带宽和处理能力就会承受额外压力。
改用客户端直传后,员工登录知识库并选择文件,后端先检查其文章编辑权限,再核对文件大小和允许类型。校验通过后,后端生成随机对象名并返回短时上传凭证。浏览器通过 OSS SDK 上传文件,同时显示进度;上传完成后,再把对象路径提交给知识库接口,由后端核验对象信息,并将它关联到对应文章。
上传失败时,页面可以提示用户重试;用户关闭页面后,未完成的上传任务按业务策略清理。下载时,系统根据文章权限生成短时访问链接,不必把私有文件设为公开读。若业务风险较高,还可以增加病毒扫描、内容审核、文件哈希校验或敏感信息检测。
接入时要检查的安全与稳定问题
-
临时凭证只给必要权限:限制 Bucket、对象前缀、操作范围和有效期。服务端密钥应放在安全配置或密钥管理服务中,不能写进客户端。
-
不要只靠扩展名判断文件:扩展名和客户端声明的 MIME 类型都可能被伪造。高风险业务应结合文件内容识别、病毒扫描和业务审核。
-
对象路径由服务端生成:避免直接使用用户输入的路径,减少同名覆盖、路径混淆和越权写入的风险。
-
跨域规则和访问授权分开配置:浏览器直传需要在 OSS 配置合适的跨域来源、请求方法和请求头。放宽跨域不能替代权限控制。
-
处理文件上传与业务登记不一致:文件进入 OSS,不代表数据库记录已经创建。数据库写入失败、重复提交或用户取消时,都要明确如何补偿或清理文件。
按场景选择上传方案
文件较小、上传量有限,而且业务规则需要集中校验,可以考虑由服务器代传。希望减少业务服务器的传输流量,通常可采用 STS 临时凭证直传;想为单次上传生成受限入口,可以评估预签名方式。大文件或网络不稳定时,再使用分片上传,并一并设计断点续传和过期任务清理。
接入前先核对目标平台对应的 OSS SDK、Bucket 权限、文件大小限制和跨域配置。测试时也别只验证正常上传:凭证过期、上传失败、重复提交和中途关闭页面,都应检查是否能正确处理。这样设计的阿里云文件上传接口,才能兼顾授权控制、结果核验和异常恢复。