如何用Flask实现亚马逊S3存储文件在浏览器中直接打开而非下载

核心问题原因 #

文件触发下载而非预览，是因为S3返回的HTTP响应头中Content-Disposition默认值为attachment，浏览器识别到该配置就会强制下载文件，而非直接渲染内容。

解决方案1：生成预签名URL时临时指定响应头 #

在调用generate_presigned_url时，在Params参数里额外添加ResponseContentDisposition和ResponseContentType两个配置项，强制S3返回符合预览要求的响应头，不需要修改S3上已存储文件的元数据，适合已经上传了大量文件的场景：

import mimetypes
from flask import redirect

@app.route('/openFileInBrowser/<filename>')
def openFileInBrowser(filename):
    bucket = 'testBucket'
    s3_client = boto3.client('s3')
    # 自动识别文件的MIME类型
    content_type = mimetypes.guess_type(filename)[0] or 'application/octet-stream'
    presigned_url = s3_client.generate_presigned_url(
        'get_object',
        Params = {
            'Bucket': bucket,
            'Key': filename,
            # 配置为inline表示要求浏览器直接预览
            'ResponseContentDisposition': f'inline; filename={filename}',
            # 配置正确的MIME类型，避免浏览器识别错误
            'ResponseContentType': content_type
        },
        ExpiresIn = 3600
    )
    return redirect(presigned_url, code=302)

解决方案2：上传文件时预先配置S3元数据（推荐） #

如果后续上传的文件都需要支持预览，可以在调用S3的put_object上传文件时直接设置文件元数据，后续生成预签名URL时不需要额外加参数，默认就支持预览：

# 上传文件时的示例代码
s3_client.put_object(
    Bucket=bucket,
    Key=filename,
    Body=file_content,
    ContentType=content_type, # 提前设置正确的MIME类型
    ContentDisposition=f'inline; filename={filename}' # 固定为预览模式
)

注意事项 #

• 只有浏览器原生支持渲染的格式才能直接预览，比如TXT、PDF、图片、音视频等，类似DOCX、XLSX、压缩包等格式浏览器本身不支持解析，还是会触发下载。
• 需要确保生成的预签名URL权限正常，没有被S3的桶策略、跨域规则拦截。

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