视频文件大,上传时间也长。网络在传到一半时断开、凭证权限不够,或 Bucket 地域和 Endpoint 对不上,都可能让上传失败。使用阿里云 OSS 上传视频,可以把文件存储和应用服务器分开,再按业务需要通过签名 URL 或 CDN 提供访问。
配置时要先想清楚两件事:视频由服务器上传,还是由浏览器直传;文件上传后由谁访问、怎样访问。选对流程,再配好权限和断点续传,通常比单纯调整上传速度更能减少故障。
一、上传前先确认 Bucket、权限和对象名称
创建 Bucket 时选对地域。地域可以优先考虑业务用户或应用服务器所在位置,并根据业务需求选择存储类型、冗余方式和读写权限。视频上传后还要频繁访问时,可以先评估标准存储。视频不需要公开访问,就将 Bucket 或对象设为私有,播放时再通过签名 URL 临时授权。
Endpoint 要对应 Bucket 地域。上传程序使用的 OSS Endpoint 必须与 Bucket 所在地域匹配。配置错了,可能遇到重定向或请求失败。不要照抄其他环境的 Endpoint,按控制台显示的信息填写,并优先使用 HTTPS。
凭证按实际用途授权。服务器上传可使用 RAM 用户或角色,只授予业务需要的 Bucket 权限。AccessKey 不要写进网页代码或公开代码仓库。浏览器直传时,由服务端签发短期有效的 STS 凭证,不要把长期密钥交给客户端。
提前规划对象 Key。OSS 通过 Bucket 和对象 Key 定位文件,并不要求先创建本地文件夹。Key 可以按业务和日期组织,例如 videos/2025/03/clip-001.mp4。应确保 Key 不会意外重复,避免覆盖已有对象;用户提交的原始文件名也不宜未经处理就直接作为 Key。
二、服务端上传:适合后台任务和已有文件
如果视频已经到达应用服务器,再由后台传到 OSS,可以使用 Python 的 oss2 SDK。大文件建议使用断点续传接口;网络中断后能否从中断处继续,取决于上传任务是否保留了续传所需的信息及运行环境。生产任务还要设置异常处理,并记录上传状态和对象 Key。
安装依赖:pip install oss2
Python 示例:
import os
import oss2
auth = oss2.Auth(os.environ[“OSS_ACCESS_KEY_ID”], os.environ[“OSS_ACCESS_KEY_SECRET”])
bucket = oss2.Bucket(auth, “https://oss-cn-hangzhou.aliyuncs.com”, “your-bucket-name”)
local_file = “/data/video.mp4”
object_key = “videos/2025/03/video-001.mp4”
result = oss2.resumable_upload(bucket, object_key, local_file,
multipart_threshold=10 * 1024 * 1024,
part_size=5 * 1024 * 1024)
print(result.status)
示例中的 Endpoint、Bucket 名称和本地路径都要替换成自己的配置。multipart_threshold 用于设置启用分片上传的阈值,part_size 是分片大小;具体值可结合文件大小和网络情况测试。上传返回后,还应检查结果、确认对象存在,并记录对应的 Key。程序没有抛出异常,不等于视频已经能正常播放。
三、浏览器直传:减少应用服务器转发
用户投稿、课程上传等场景,可以让浏览器直接把视频传到 OSS。常见流程是:用户向业务服务端申请上传;服务端校验登录状态和文件信息,生成对象 Key,再返回短期有效的 STS 凭证或签名信息;浏览器通过官方 SDK 上传;上传完成后将对象 Key 回传给服务端,由业务系统保存视频记录。
这样文件不必先经过应用服务器,能减少服务器的带宽和磁盘压力。但权限边界要由服务端控制:凭证应有有效期和授权范围,对象写入路径也应受限制。前端检查文件类型只能改善交互,不能代替服务端校验和权限控制。
浏览器跨域上传还需要配置 OSS 的 CORS,按实际请求设置允许的来源域名、方法和请求头。排查时要确认浏览器使用的域名与 CORS 规则一致。CORS 只处理浏览器跨域访问规则,不会授予上传权限。测试通过后,收紧不需要的来源和请求范围,避免长期保留过宽配置。
四、案例:在线课程平台怎样安排上传流程
某在线课程平台允许讲师上传数百 MB 到数 GB 的视频。原先视频先传到应用服务器,再由后台上传 OSS。高峰期服务器带宽占用明显,上传时间变长后,用户还会重新提交。平台改用浏览器直传:讲师提交课程后,服务端生成随机对象 Key,并签发只能在指定目录写入的短期凭证;浏览器上传完成,再把 Key 和课程编号提交给后台。
后台收到完成信息后,检查对象是否存在、文件大小是否符合预期,再将视频状态设为“待处理”。转码完成后,平台保存播放地址或访问所需的授权信息。原始视频保持私有,学员访问时由服务端生成限时签名 URL。
这套流程减少了应用服务器转发文件的负担,也没有把长期密钥交给讲师端。上传页面还可以显示进度,并在失败时提供重试和超时提示。遇到网络中断时,用户能看见任务状态,就不容易因页面没有反馈而反复提交。
五、常见问题的排查顺序
- 上传时报权限错误:核对 RAM 授权范围、Bucket 名称、对象路径和凭证有效期。排错时不要直接给长期密钥增加过宽权限。
- 浏览器请求被拦截:检查 OSS CORS 中的来源、方法和请求头,并与实际请求逐项比对。即使 CORS 配置正确,凭证或对象权限不足,上传仍会失败。
- 大文件速度慢或中断:优先测试分片上传或断点续传,再根据文件大小和网络情况调整分片大小。也要检查客户端网络、地域距离和并发设置;并发开得过高,可能影响同一业务的其他请求。
- 上传成功但无法播放:确认对象完整、播放地址有访问权限,并检查视频编码是否受播放器支持。OSS 负责存储文件,不会自动替你完成转码或生成兼容格式。
- 视频不适合公开访问:课程、个人视频和内部资料可使用私有读与签名 URL。需要公开分发时,再结合 CDN、访问控制和防盗链策略评估。
阿里云 OSS 上传视频时,先按文件来源和业务流量选择上传方式:后台已有文件,可从 SDK 上传和断点续传开始;面向用户的大文件上传,可以评估 STS 授权直传。上线前用测试 Bucket 跑通上传、权限校验和播放流程,并检查对象 Key、失败重试及访问方式。这样更容易定位问题,也能避免把上传成功误当成整条视频处理链路已经完成。