使用PHP S3 API预签名URL上传至S3的MP4视频无法流式播放

我来帮你一步步梳理这个问题——视频能成功上传到S3却没法流式播放，通常和Content-Type设置、CORS配置或者请求头限制有关，下面是具体的解决方向：

1. 确保上传时设置了正确的Content-Type #

S3默认会把上传的文件标记为binary/octet-stream，但MP4视频需要设置为video/mp4才能被浏览器正确识别并支持流式播放。你需要在生成预签名URL时明确指定这个类型，同时前端上传时也要匹配该Content-Type。

修改你的PHP预签名URL生成代码： #

在创建PutObject命令时，添加ContentType参数：

require 'aws/aws-autoloader.php';
use Aws\S3\S3Client;
use Aws\Exception\AwsException;

$s3Client = new Aws\S3\S3Client([
    'version' => 'latest',
    'region' => 'ap-south-1',
    'credentials' => [
        'key' => 'XXXXXXX',
        'secret' => 'XXXXXXX'
    ]
]);

// 替换为你的桶名和对象路径
$bucket = 'your-bucket-name';
$key = 'path/to/target/video.mp4';

// 生成预签名URL时，明确指定视频MIME类型
$cmd = $s3Client->getCommand('PutObject', [
    'Bucket' => $bucket,
    'Key' => $key,
    'ContentType' => 'video/mp4' // 关键配置：指定正确的视频类型
]);

$request = $s3Client->createPresignedRequest($cmd, '+20 minutes');
$presignedUrl = (string)$request->getUri();

echo $presignedUrl;

前端上传时同步设置Content-Type： #

比如用Fetch API上传时，要确保请求头和预签名URL指定的类型一致：

fetch(presignedUrl, {
    method: 'PUT',
    body: videoFile,
    headers: {
        'Content-Type': 'video/mp4' // 和后端预签名配置匹配
    }
})

2. 检查S3桶的CORS配置 #

流式播放时，浏览器会发送Range请求头来分段加载视频，如果你的S3桶CORS配置没有允许这个头，浏览器会拦截请求，导致无法流式播放。

更新桶的CORS规则： #

进入AWS S3控制台，找到目标桶→「权限」→「跨域资源共享(CORS)」，替换为以下配置（可根据实际需求限制域名）：

[
    {
        "AllowedHeaders": ["*"],
        "AllowedMethods": ["GET", "PUT"],
        "AllowedOrigins": ["*"], // 建议替换为你的业务域名，比如["https://your-app.com"]
        "ExposeHeaders": ["Content-Range", "Accept-Ranges"]
    }
]

注意：ExposeHeaders里的Content-Range和Accept-Ranges是流式播放必须的响应头，必须配置暴露给前端。

3. 验证视频文件本身的完整性 #

有时候文件虽然显示上传成功，但可能在传输过程中损坏。你可以直接从S3控制台下载该视频，本地尝试播放：

• 如果本地也无法播放，说明上传的源文件有问题，检查前端上传的文件是否完整、上传过程是否中断；
• 如果本地能正常播放，回到上面的Content-Type和CORS配置继续排查。

4. 确认S3对象的存储类 #

如果你的视频对象存储类是Glacier、Glacier Flexible Retrieval或Deep Archive这类归档存储，是无法直接流式播放的，需要先将对象恢复到「标准」或「智能分层」等可即时访问的存储类。你可以在S3控制台查看对象的「存储类」信息确认。

按照上面的步骤逐一排查，应该就能解决流式播放的问题了。

内容的提问来源于stack exchange，提问作者Rahul Gaikwad