Rails + ActiveStorage（基于S3）：如何自定义文件下载文件名？

好问题！当你用Amazon S3存储文件，但希望用户下载时看到自定义的文件名（而不是S3上的原始文件名），有几个实用的方案可以解决这个问题，我给你逐个拆解：

方案1：生成预签名URL时指定Content-Disposition #

直接用url_for生成的S3链接会默认使用原始文件名，这时候我们可以绕过url_for，直接用AWS SDK（比如boto3）生成预签名URL，并在生成时添加ResponseContentDisposition参数来指定下载文件名。

举个Flask后端的例子：

import boto3
from botocore.config import Config

def get_presigned_headshot_url(user):
    # 初始化S3客户端（建议把配置抽离到环境变量）
    s3 = boto3.client(
        's3',
        aws_access_key_id=YOUR_ACCESS_KEY,
        aws_secret_access_key=YOUR_SECRET_KEY,
        config=Config(signature_version='s3v4')
    )
    # 生成带自定义文件名的预签名URL
    return s3.generate_presigned_url(
        'get_object',
        Params={
            'Bucket': 'your-bucket-name',
            'Key': user.headshot_file.key,  # S3上的原始文件Key
            'ResponseContentDisposition': f'attachment; filename="{user.username}__headshot.jpg"'
        },
        ExpiresIn=3600  # 链接有效期，单位秒，按需调整
    )

然后在你的视图函数里调用这个方法，把预签名URL传给模板：

@app.route('/user/<int:user_id>')
def user_profile(user_id):
    user = User.query.get_or_404(user_id)
    custom_download_url = get_presigned_headshot_url(user)
    return render_template('profile.html', user=user, headshot_download_url=custom_download_url)

模板里直接用这个URL即可：

<a href="{{ headshot_download_url }}" download>下载头像</a>

这个方案的优点是灵活，可以根据用户信息动态生成文件名，而且不需要修改S3上的文件元数据。

方案2：上传文件时设置S3对象的Content-Disposition元数据 #

如果这个文件的下载文件名是固定的（比如每个用户的头像文件名固定对应用户名），可以在上传文件到S3的时候就设置对象的Content-Disposition元数据。

上传时的代码示例：

s3.upload_file(
    'local_headshot.jpg',  # 本地文件路径
    'your-bucket-name',
    '4321431-small.jpg',  # S3上的存储Key
    ExtraArgs={
        'ContentDisposition': 'attachment; filename="jon_smith__headshot.jpg"',
        'ContentType': 'image/jpeg'  # 建议同时指定文件类型
    }
)

设置之后，不管用户访问哪个链接（包括url_for生成的链接）下载这个文件，浏览器都会自动使用你指定的文件名保存。这个方案的优点是一劳永逸，不需要每次生成链接都做额外处理，但缺点是不够灵活，无法动态修改文件名。

方案3：通过后端代理下载（适合需要权限校验的场景） #

如果你的头像需要权限控制（比如只有用户自己或管理员能下载），或者需要在下载前执行一些业务逻辑，可以让后端作为代理：先从S3获取文件内容，然后在响应头里设置Content-Disposition，再把文件返回给用户。

Flask视图函数的例子：

from flask import send_file, abort
import io
import boto3

@app.route('/download-headshot/<int:user_id>')
def download_headshot(user_id):
    user = User.query.get_or_404(user_id)
    # 这里可以添加权限校验逻辑，比如只有当前登录用户是本人才能下载
    if current_user.id != user_id and not current_user.is_admin:
        abort(403)
    
    # 从S3获取文件
    s3 = boto3.client('s3')
    try:
        s3_response = s3.get_object(Bucket='your-bucket-name', Key=user.headshot_file.key)
    except s3.exceptions.NoSuchKey:
        abort(404)
    
    # 将文件内容转为BytesIO对象
    file_content = io.BytesIO(s3_response['Body'].read())
    
    # 返回文件，指定自定义文件名
    return send_file(
        file_content,
        mimetype='image/jpeg',
        as_attachment=True,
        download_name=f"{user.username}__headshot.jpg"
    )

模板里使用url_for指向这个视图：

<a href="{{ url_for('download_headshot', user_id=user.id) }}">下载我的头像</a>

这个方案的优点是完全可控，可以加入权限校验、日志记录等逻辑，但缺点是后端需要处理文件传输，对于大文件可能会占用服务器资源，建议配合流式传输优化。

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