如何使用Python boto3实现S3文件跨目录完整移动并校验移动结果

S3 剪切粘贴（移动）文件的安全实现方案 #

S3 本身没有原生的「移动/剪切」API 接口，所有类剪切粘贴的移动操作底层都是先复制到目标路径、校验复制结果、确认无误后再删除源文件的流程，要确保文件完整移动成功，核心是在复制和删除之间增加校验逻辑，确认复制的文件完全正确后再执行删除。

你现有代码中的删除逻辑存在参数错误，s3_client.Object() 第二个参数需要传入源文件的 Key 字符串，而不是你定义的source字典，以下是完整的安全实现代码：

import boto3

# 初始化S3资源
s3 = boto3.resource('s3')
bucket_name = 'mybucket'
# 替换为你的源文件路径和目标路径
source_key = 'some key'
dest_key = 'my/destination_file_path'
bucket = s3.Bucket(bucket_name)

try:
    # 1. 提前获取源文件元信息，用于后续校验
    source_obj = bucket.Object(source_key)
    source_size = source_obj.content_length
    source_etag = source_obj.e_tag

    # 2. 执行复制操作
    copy_source = {
        'Bucket': bucket_name,
        'Key': source_key
    }
    bucket.copy(copy_source, dest_key)

    # 3. 校验目标文件完整性
    dest_obj = bucket.Object(dest_key)
    dest_obj.load() # 主动触发请求，确认目标文件确实存在
    # 同时校验文件大小和ETag，确保内容完全一致
    if dest_obj.content_length == source_size and dest_obj.e_tag == source_etag:
        # 校验通过，删除源文件完成移动
        source_obj.delete()
        print(f"文件移动成功：{source_key} -> {dest_key}")
    else:
        # 校验不通过，删除异常的目标文件，保留源文件回滚操作
        dest_obj.delete()
        raise Exception("目标文件和源文件内容不匹配，移动操作已回滚")
except Exception as e:
    print(f"文件移动失败：{str(e)}")

注意事项 #

• 普通单段上传的文件ETag就是文件的MD5值，分段上传的文件ETag也可以唯一标识文件内容，对比ETag+文件大小可以100%确认复制后的文件和源文件完全一致。
• 对于大于5GB的大文件，建议使用分段复制逻辑避免单次复制超时，分段复制完成后同样校验全文件的ETag和大小即可。
• 生产环境可以给复制、校验、删除步骤增加重试机制，进一步提升操作稳定性。

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