使用boto3生成的AWS S3 presigned URL如何实现浏览器预览而非自动下载

问题原因 #

S3返回的Content-Disposition响应头为attachment时会触发浏览器下载行为，同时如果Content-Type不符合浏览器可预览的类型规则，也会强制下载。

方案1：生成预签名URL时指定响应头（推荐，无需修改原对象） #

在调用boto3的generate_presigned_url方法时，额外传入响应头覆盖参数即可，示例代码如下：

import boto3

s3_client = boto3.client('s3')
presigned_url = s3_client.generate_presigned_url(
    ClientMethod='get_object',
    Params={
        'Bucket': '你的桶名',
        'Key': 'S3对象的文件路径',
        # 核心参数：指定inline让浏览器直接预览而不是下载
        'ResponseContentDisposition': 'inline',
        # 按需设置正确的文件MIME类型，比如图片用image/jpeg，PDF用application/pdf
        'ResponseContentType': 'application/pdf'
    },
    ExpiresIn=3600 # 签名有效期，单位秒
)

如果不确定文件的MIME类型，可以先调用head_object接口获取原对象的ContentType再传入。

方案2：修改S3原对象的元数据（适合所有访问场景都需要预览的情况） #

如果该文件所有访问场景都需要预览，可以直接修改S3对象的永久元数据：

1. 登录S3控制台，找到对应对象，在「元数据」 tab 新增：
   • 键：Content-Disposition，值：inline
   • 键：Content-Type，值：对应文件的正确MIME类型
2. 也可以通过boto3批量修改，示例代码：

s3_client.copy_object(
    Bucket='你的桶名',
    Key='S3对象的文件路径',
    CopySource={'Bucket': '你的桶名', 'Key': 'S3对象的文件路径'},
    ContentDisposition='inline',
    ContentType='application/pdf',
    MetadataDirective='REPLACE'
)

注意事项 #

• 只有浏览器支持预览的文件类型才会生效，比如图片、PDF、普通文本、音视频等，可执行文件、压缩包等类型无论如何设置都会触发下载
• 如果使用了CDN加速S3资源，修改配置后需要清理CDN缓存才会生效
• 生成预签名URL时指定的响应头参数优先级高于S3对象的原生元数据

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