如何用Python+Boto3实现AWS S3带版本管理的文件上传与下载？

直接用AWS S3自带的版本控制功能是最靠谱的方案——不需要手动维护文件夹结构，也不用额外搭RDS存版本信息，S3会自动帮你跟踪每个文件的所有版本，默认返回最新版本，完全满足你的需求。

步骤1：启用S3存储桶的版本控制 #

首先得给目标存储桶开启版本控制，用Boto3代码就能完成：

import boto3

s3 = boto3.client('s3')
bucket_name = "your-bucket-name"

# 启用版本控制
s3.put_bucket_versioning(
    Bucket=bucket_name,
    VersioningConfiguration={
        'Status': 'Enabled'
    }
)

启用后，每次上传同一路径的文件，S3都会自动生成唯一的版本ID，旧版本不会被覆盖，而是保留在桶里。

步骤2：上传文件（自动生成版本） #

上传时不需要手动指定版本，直接用常规方法即可，S3会自动为新文件分配版本ID：

def upload_file_to_s3(local_file_path, s3_key):
    s3 = boto3.client('s3')
    bucket_name = "your-bucket-name"
    
    # 上传文件后，通过head_object获取版本ID
    s3.upload_file(local_file_path, bucket_name, s3_key)
    head_response = s3.head_object(Bucket=bucket_name, Key=s3_key)
    version_id = head_response['VersionId']
    print(f"文件已上传，版本ID: {version_id}")
    return version_id

# 调用示例：上传本地document.txt到S3的Document1/file_name.txt路径
upload_file_to_s3("./document.txt", "Document1/file_name.txt")

步骤3：下载指定版本的文件 #

如果用户需要特定版本，先通过list_object_versions拿到该文件的所有版本列表，找到对应版本ID后下载：

def download_specific_version(s3_key, version_id, local_save_path):
    s3 = boto3.client('s3')
    bucket_name = "your-bucket-name"
    
    s3.download_file(
        Bucket=bucket_name,
        Key=s3_key,
        Filename=local_save_path,
        ExtraArgs={'VersionId': version_id}
    )
    print(f"已下载版本ID {version_id} 的文件到 {local_save_path}")

# 调用示例
download_specific_version("Document1/file_name.txt", "your-version-id", "./downloaded_old_version.txt")

步骤4：下载最新版本的文件 #

完全不需要额外处理，直接调用下载方法，S3默认返回该文件的最新版本：

def download_latest_version(s3_key, local_save_path):
    s3 = boto3.client('s3')
    bucket_name = "your-bucket-name"
    
    s3.download_file(bucket_name, s3_key, local_save_path)
    print(f"已下载最新版本文件到 {local_save_path}")

# 调用示例
download_latest_version("Document1/file_name.txt", "./downloaded_latest.txt")

步骤5：获取文件的所有版本列表 #

如果需要展示版本历史，用下面的方法列出指定文件的所有版本：

def list_file_versions(s3_key):
    s3 = boto3.client('s3')
    bucket_name = "your-bucket-name"
    
    response = s3.list_object_versions(Bucket=bucket_name, Prefix=s3_key)
    versions = response.get('Versions', [])
    
    # 按上传时间倒序排列（最新的在前）
    sorted_versions = sorted(versions, key=lambda x: x['LastModified'], reverse=True)
    
    print("文件版本列表：")
    for v in sorted_versions:
        print(f"版本ID: {v['VersionId']}, 上传时间: {v['LastModified']}, 大小: {v['Size']} bytes")
    
    return sorted_versions

# 调用示例
list_file_versions("Document1/file_name.txt")

对比你的两种思路 #

• 思路1：手动建版本文件夹的问题在于，每次上传都要手动管理版本命名，获取最新版本需要遍历文件夹找最新的，效率低还容易出错，完全没必要——S3原生版本控制已经帮你做好了版本的自动管理。
• 思路2：用RDS存版本信息会增加系统复杂度，不仅要维护数据库，还要保证S3和数据库的版本信息一致（比如上传成功后要更新数据库，删除版本时也要同步），容易出现数据不一致的问题。而S3原生版本控制是原子性的，版本信息和文件本身绑定，不会出错。

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