如何在django-storages中使用S3版本控制获取文件特定版本？

刚好我之前也折腾过django-storages结合S3版本控制的场景，给你梳理下这两个问题的解决办法：

1. 获取Document的特定版本内容或访问链接 #

你想要的doc.s3_file.read(version=XXX)这种直接调用的方式，默认FileField并没有提供，但咱们可以通过两种方式实现需求：

方式一：生成带版本的访问URL #

django-storages的S3Storage自带的url()方法支持传递S3的原生参数，这里要注意，S3官方的版本参数名是versionId，不是你猜测的version。你可以直接给url()方法传这个参数生成对应版本的链接：

# 假设你已经拿到Document实例doc，以及目标版本号version_id
versioned_url = doc.s3_file.url(versionId=version_id)

生成的URL可以直接用来访问该版本的文件，不管是前端调用还是后端请求都能用。

方式二：后端直接读取特定版本内容 #

如果需要在后端代码里直接读取对应版本的文件内容，可以借助django-storages底层的boto3客户端来操作：

# 从你的Document实例获取存储对象和文件键
storage = doc.s3_file.storage
file_key = doc.s3_file.name

# 获取boto3的S3客户端
s3_client = storage.connection

# 调用S3的get_object接口指定版本号
response = s3_client.get_object(
    Bucket=storage.aws_s3_bucket_name,
    Key=file_key,
    VersionId=version_id
)

# 读取文件内容
file_content = response['Body'].read()

这样就能直接拿到对应版本的文件二进制内容了。

2. 获取文件的所有可用版本 #

要列出某个文件的所有版本，同样通过boto3客户端的list_object_versions方法实现，我建议你可以封装成Document模型的方法，用起来更方便：

class Document(models.Model):
    name = models.CharField(max_length=255)
    s3_file = models.FileField(storage=storage)
    
    # 新增方法：获取当前文件的所有版本
    def get_all_versions(self):
        storage = self.s3_file.storage
        s3_client = storage.connection
        
        # 调用S3接口列出指定文件的所有版本
        response = s3_client.list_object_versions(
            Bucket=storage.aws_s3_bucket_name,
            Prefix=self.s3_file.name  # 用Prefix精准匹配单个文件
        )
        
        # 提取版本列表，注意S3会返回Versions和DeleteMarkers（删除标记），按需选择
        versions = response.get('Versions', [])
        # 如果需要包含删除标记，可以加上下面一行
        # versions.extend(response.get('DeleteMarkers', []))
        
        # 每个版本对象包含VersionId、LastModified、Size等元数据
        return versions

之后你只需要调用doc.get_all_versions()，就能拿到该文件的所有版本列表，每个元素里的VersionId就是你需要的版本标识。

额外注意事项 #

• 确保你的S3存储桶已经开启版本控制，这是所有操作的前提，没有开启的话S3不会保存版本记录。
• 建议使用较新版本的django-storages，避免旧版本存在的兼容性问题。

内容的提问来源于stack exchange，提问作者Jorge Arévalo