阿里云VOD控制台视频卡在“上传中”状态

Question

阿里云VOD控制台视频上传卡在“上传中”状态，常见于网络不稳定或分片上传中断导致的断点续传失败。此外，浏览器兼容性问题（如使用老旧版本IE）或上传过程中页面刷新、关闭，也可能造成状态未及时同步。虽文件实际已上传完成，但控制台仍显示“上传中”，影响用户判断。如何正确排查并解决该类上传状态异常问题？

Answer 1

阿里云VOD上传状态卡在“上传中”的深度排查与解决方案

1. 问题现象与初步判断

用户在使用阿里云视频点播（VOD）控制台上传视频时，常遇到上传进度长时间停留在“上传中”状态。尽管本地文件可能已完整传输至服务端，但控制台界面未更新为“上传完成”或“转码中”，导致操作中断或重复上传。

• 典型场景：网络波动导致分片上传失败
• 常见诱因：浏览器兼容性差（如IE11）、页面刷新/关闭
• 核心矛盾：客户端状态未与服务端同步

2. 分层排查路径设计

采用自底向上的分析方法，从网络层到应用层逐步验证：

1. 确认本地网络稳定性（ping、traceroute检测）
2. 检查浏览器控制台是否有JS错误（F12 → Console）
3. 查看HTTP请求是否完整发送所有分片
4. 比对OSS实际对象存储中的文件完整性
5. 调用API查询视频上传任务的真实状态

3. 关键技术点解析

技术维度	具体表现	影响机制
分片上传协议	每个分片独立上传，依赖Etag校验	任一分片失败将阻断合并流程
断点续传逻辑	基于uploadId记录上传进度	uploadId丢失则无法恢复会话
浏览器兼容性	IE不支持File API或XHR2	前端无法读取文件切片
跨域策略CORS	OSS预检请求失败	阻止后续PUT操作
事件回调延迟	服务端处理完但未通知控制台	状态机未触发变更

4. 核心诊断命令与API调用

// 查询指定视频的详细信息（通过OpenAPI Explorer调试）
GET /v1.0/media?videoId=YOUR_VIDEO_ID
Headers: 
  Authorization: Bearer YOUR_TOKEN
  Content-Type: application/json

// 响应示例：
{
  "Media": {
    "Status": "Uploading",  // 注意此状态是否滞后
    "FileSize": 1073741824,
    "CreationTime": "2025-04-05T10:00:00Z"
  }
}
    

5. 状态不一致的根本原因分类

根据日志和行为模式，可归纳为以下三类：

• 客户端侧中断：用户主动关闭页面，JavaScript运行环境销毁，未能发起最终合并请求（CompleteMultipartUpload）
• 服务端残留会话：部分分片已上传，但未完成合并，uploadId处于悬空状态
• 元数据同步延迟：OSS物理上传完成，但VOD系统未及时更新数据库记录

6. 解决方案实施流程图

graph TD
            A[上传卡住] --> B{是否能访问OSS控制台?}
            B -->|是| C[查找对应Bucket中文件是否存在]
            B -->|否| D[使用RAM账号登录并授权访问]
            C --> E{文件大小匹配源文件?}
            E -->|是| F[调用VOD RefreshUploadVideo接口]
            E -->|否| G[重新发起上传，启用断点续传SDK]
            F --> H[等待状态刷新]
            H --> I[确认变为'转码中'或'上传完成']
            G --> J[监控分片上传成功率]

7. 推荐最佳实践

为避免此类问题反复发生，建议采取以下措施：

• 使用官方提供的Web Upload SDK替代原生HTML表单上传
• 在生产环境中禁用IE浏览器访问控制台
• 部署前端异常监控，捕获unhandledrejection和error事件
• 定期清理超过7天未完成的Multipart Upload任务（可通过Lifecycle规则）
• 对大文件（>2GB）启用带校验的分片上传策略

8. 高级运维脚本示例

#!/bin/bash
# 清理陈旧的分片上传任务（需配置aliyun-cli）
BUCKET_NAME="your-vod-bucket"
DAYS_AGO=$(date -u -d '7 days ago' +"%Y-%m-%dT%H:%M:%SZ")

echo "正在查询过期的Multipart Uploads..."
aliyun oss list --bucket $BUCKET_NAME --uploads \
  | grep -E "UploadId|Key" \
  | awk 'NR%2==1 {printf "%s ", $0; next} {print $0}' \
  | while read -r line; do
      upload_id=$(echo $line | awk '{print $1}')
      object_key=$(echo $line | awk '{print $2}')
      creation_date=$(echo $line | awk '{print $3" "$4}')
      if [[ "$creation_date" < "$DAYS_AGO" ]]; then
          echo "删除过期上传任务: $object_key, ID=$upload_id"
          aliyun oss abort-multipart-upload --bucket $BUCKET_NAME \
            --key "$object_key" --upload-id "$upload_id"
      fi
done
    

9. 与CDN及安全策略的联动考量

某些企业架构中，上传链路经过代理或WAF设备，可能导致：

• TCP连接被中间件提前终止
• 大分片触发IPS阈值拦截
• SNI过滤导致SSL握手失败

建议在防火墙策略中放行以下域名：

*.oss-cn-*.aliyuncs.com vod-upload.cn-*.aliyuncs.com

10. 后续可观测性建设方向

构建完整的上传质量监控体系：

监控指标	采集方式	告警阈值
平均分片上传耗时	埋点+日志分析	>30s
上传中断率	前端异常上报	>5%
OSS碎片数量	定时扫描	>100个
元数据延迟	对比OSS LastModified vs VOD CreateTime	>5分钟