市场部做完一条宣传片，在控制台上传，进度走到一半报错，很多团队都遇到过。视频传到云端这一步看起来简单，但文件变大、网络变差、权限没配对，问题会接连出现：传不动、断了要从头来、转码后播放卡顿。这篇文章按使用场景讲阿里云视频上传的几种方式、完整流程，以及失败时该先查什么。
一、先确定你的上传场景
选上传方式，主要看每天传多少、由谁来传。一个知识博主每月发几条视频，和一家在线教育平台每天接收几千条讲师视频，用的方案完全不同。
- 偶发少量上传：比如市场部每月做两三条宣传片，直接在控制台上传就够，不用写代码。
- 用户端上传：比如社区 App 允许用户发短视频，视频要从手机直接传到云端，通常需要客户端 SDK 或分片上传能力。
- 批量与自动化上传：比如媒体机构每天从采集设备同步素材，需要通过 API 或命令行工具批量处理，并接入自己的任务系统。
场景定下来，再选工具，返工会少很多。
二、几种主要上传方式
1. 控制台上传
登录阿里云视频点播控制台，进入媒资管理页面，选择上传即可。界面直观，上传完成后可以直接看转码进度和播放地址，适合人工操作。文件一多就很慢，也没法嵌进业务系统，所以只适合偶尔传几条。
2. 服务端 API 上传
典型做法分两步：先调用接口拿到上传凭证（包括上传地址和临时访问凭证），再由客户端或服务端用这个凭证把文件推送到对象存储。好处是长期有效的 AccessKey 只留在服务端，不会暴露给前端页面。
生成凭证的接口名称和参数，请以阿里云官方 SDK 文档为准，上线前逐项核对，不要照搬旧版示例。密钥从环境变量或密钥管理服务读取，不要写进代码。
3. 客户端 SDK 分片上传
视频较大，或者用户网络不稳定时，分片上传基本是必选项。SDK 把文件切成小块逐个上传，断网后从断点继续，不必整个文件重传。某在线教育平台的讲师在外地用移动网络上传一节 90 分钟的课程视频，原来平均要重试三四次，改成分片断点续传后，成功率明显提高，客服工单也少了。
4. 命令行与批量工具
要迁移大量历史素材时，可以写脚本，配合阿里云命令行工具或 SDK 批量上传。脚本里要加日志和失败重试，并把已经成功的文件路径记入清单。否则中断后重跑，同一批文件会被重复上传，既占带宽，也多花存储费用。
三、一次完整上传是怎么走的
不管用哪种方式，流程基本一致：
- 服务端校验用户身份和权限，确认该用户有上传资格。
- 服务端调用接口获取上传凭证，凭证有效期设短一些。
- 客户端或服务端用凭证上传文件，SDK 负责分片和重试。
- 上传完成后，回调通知业务系统，记录视频 ID。
- 系统触发转码，生成不同清晰度的播放版本。
- 转码完成，业务系统更新视频状态，再开放给用户或观众。
第 4 步的回调最容易漏。上传已经成功，业务系统却没收到通知，视频一直显示“处理中”，用户以为上传失败，又重传了一次。回调和状态流转要在设计阶段画清楚，每个状态由谁更新，失败后怎么处理，都要提前定下来。
四、常见问题怎么查
上传很慢
先分清是本地网络慢，还是地域选错了。用户在华南，存储桶在华北，跨地域传输会拉长耗时。可以换成就近的地域，或者开启传输加速。测试时用同一个文件，在不同网络下各传一次，对比结果，就能判断瓶颈在哪一端。
中途失败
大文件传到一半失败，常见原因是网络波动、凭证过期、单次请求超时。如果凭证在上传过程中过期，要在客户端实现凭证刷新，而不是整个流程从头再来。日志里记下请求 ID，提工单时能省掉很多来回沟通。
报 403 或权限错误
先查 RAM 子账号有没有视频点播相关权限，再查存储桶的访问策略，最后看凭证中的资源范围和实际上传路径是否一致。这类问题多半是策略没对齐，改代码解决不了。
文件格式不对
格式问题多出现在用户随手上传的素材上，比如封装格式不支持、编码特殊，或者文件本身损坏。上传前先用本地播放器打开一遍，确认能正常播放。具体支持哪些格式，以阿里云官方文档为准。服务端可以在回调或预检环节读取文件基本信息，不合规的直接拦下，不必等到转码失败才发现。
上传成功但不能播放
多半与转码或播放鉴权有关。依次确认三件事：转码模板是否配置，转码任务是否跑完，播放地址用的域名和鉴权方式是否正确。如果开启了播放鉴权，前端拿到的播放地址必须带有效的签名参数，签名过期后播放会直接失败。
五、几点实践建议
- 凭证只给必要的权限。上传路径和操作类型都限定好，有效期尽量短。
- 服务端再核对一遍。客户端传来的时长、大小、格式不能直接信任，入库前在服务端重新校验。
- 提前算存储成本。原始文件和转码文件都占空间，定期清理废弃素材，按访问频率选择合适的存储类型。
- 监控上传成功率和转码耗时。按失败原因分类统计，指标突然波动时及时告警。
- 原始文件多留一份。转码参数之后大概率要调整，留着原片，就不用让用户重新上传。
