使用boto3上传至AWS S3的图片无法在浏览器预览，控制台上传正常

核心原因 #

浏览器是否预览文件，主要由S3返回的Content-Disposition响应头决定。通过AWS控制台上传图片时，S3会自动为图片类文件设置Content-Disposition: inline，让浏览器直接预览；而用boto3的put_object上传时，若未显式指定该参数，S3不会自动添加这个头，部分浏览器会默认触发下载行为。

修复步骤 #

1. 修正代码语法错误：你提供的代码中Key = "image.png"行末尾缺少逗号，这会导致代码运行报错，先补上：

result = s3.put_object(
    Bucket = "my-bucket",
    Key = "image.png",  # 补上此处逗号
    Body = decoded_image,
    ContentType = "image/png",
    Tagging = "Key1=Value1",
    ContentDisposition = "inline"  # 添加该参数指定预览方式
)

2. 显式指定ContentDisposition参数：在put_object中添加ContentDisposition = "inline"，强制S3返回该响应头，告诉浏览器直接预览图片而非下载。

3. 修复已上传的问题图片：对于已经上传的图片，可以通过copy_object方法修改元数据：

s3.copy_object(
    Bucket = "my-bucket",
    Key = "image.png",
    CopySource = {"Bucket": "my-bucket", "Key": "image.png"},
    ContentDisposition = "inline",
    ContentType = "image/png",
    MetadataDirective = "REPLACE"  # 替换原有元数据
)

补充说明 #

• 即使ContentType设置正确，缺少Content-Disposition: inline时，部分移动端或特定版本浏览器仍会选择下载文件。
• 若需要同时支持预览和指定保存文件名，可设置ContentDisposition = "inline; filename=自定义名称.png"。

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