如何删除S3存储桶中二级可变子文件夹？现有代码存在局限

问题核心：S3不存在真实的文件夹结构，所谓“文件夹”本质是对象键的前缀。你的代码仅尝试删除folder1/下二级前缀对应的空文件夹对象（零字节文件），但当该前缀下存在folder3及其中的对象时，直接删除前缀对象无效，必须先清理该前缀下的所有对象。

修正后的实现步骤 #

• 遍历folder1/下的所有二级前缀（即动态命名的folder2层级）
• 对每个二级前缀，列出其下所有对象（包括子文件夹folder3内的对象）
• 批量删除这些对象
• （可选）删除二级前缀对应的空文件夹对象（如果存在）

代码实现 #

import boto3

s3 = boto3.resource('s3')
client = boto3.client('s3')
mybucket = 'your-bucket-name'

# 遍历folder1下的所有二级前缀
prefix = "folder1/"
result = client.list_objects_v2(Bucket=mybucket, Delimiter='/', Prefix=prefix)

for common_prefix in result.get('CommonPrefixes', []):
    folder2_prefix = common_prefix.get('Prefix')
    # 用分页器列出该前缀下的所有对象（含子文件夹内的）
    paginator = client.get_paginator('list_objects_v2')
    page_iterator = paginator.paginate(Bucket=mybucket, Prefix=folder2_prefix)
    
    # 批量删除对象
    for page in page_iterator:
        if 'Contents' in page:
            objects_to_delete = [{'Key': obj['Key']} for obj in page['Contents']]
            client.delete_objects(Bucket=mybucket, Delete={'Objects': objects_to_delete})
    
    # 尝试删除空文件夹对象
    try:
        s3.Object(mybucket, folder2_prefix).delete()
    except Exception:
        # 无对应空文件夹对象时忽略错误
        pass

关键说明 #

• 用分页器paginator处理大量对象，规避单次请求的结果数量限制
• 先清理前缀下所有实际存储的对象，再处理空文件夹，确保整个二级目录层级被彻底删除
• 捕获删除空文件夹的异常，避免因无对应对象导致程序报错

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