AWS S3 Bucket使用list_objects_v2返回完整Key路径而非文件名的原因

这其实是AWS S3的核心设计特性导致的，咱们一步步说清楚：

1. S3没有真正的“目录”结构 #

AWS S3本质上是扁平的对象存储服务，不存在传统文件系统里的目录/文件夹概念。你看到的sub_dir_1/sub_dir_2/这种层级，只是通过对象Key里的/分隔符模拟出来的视觉效果而已。对S3来说，sub_dir_1/sub_dir_2/my_csv_file.csv就是这个对象的唯一完整标识符——它不是“存放在子目录里的文件”，而是一个单独的对象，Key里的前缀只是命名规则的一部分。

2. 你的代码逻辑没问题 #

你用list_objects_v2获取到的obj['Key']，本来就是对象的完整标识符，所以自然会包含所有模拟层级的前缀内容，这完全是正常现象，不是代码或者配置出了问题。

3. 如何提取仅文件名？ #

如果只需要获取文件名部分，可以用Python的字符串处理工具来提取：

方法1：用os.path.basename()（推荐，跨平台友好） #

import os

file_name = 'my_file.csv'
resp = s3_client_conn.list_objects_v2(Bucket='bucket_1')
for obj in resp['Contents']:
    if file_name in obj['Key']:
        # 提取纯文件名
        pure_file_name = os.path.basename(obj['Key'])
        print(pure_file_name)

方法2：手动分割字符串 #

如果不想引入os模块，也可以直接按/分割取最后一段：

file_name = 'my_file.csv'
resp = s3_client_conn.list_objects_v2(Bucket='bucket_1')
for obj in resp['Contents']:
    if file_name in obj['Key']:
        pure_file_name = obj['Key'].split('/')[-1]
        print(pure_file_name)

小技巧：精准过滤对象 #

如果已经知道文件所在的前缀路径，建议在list_objects_v2里加上Prefix参数，这样可以只返回该前缀下的对象，减少遍历的数量：

resp = s3_client_conn.list_objects_v2(
    Bucket='bucket_1',
    Prefix='sub_dir_1/sub_dir_2/'  # 指定前缀，缩小查询范围
)

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