AWS S3 listObjectsV2Paginator能否仅返回目录或文件以提升效率？

完全可以通过配置请求参数，让listObjectsV2Paginator只返回你需要的类型，避免同时获取两类数据以提升效率：

1. 仅返回文件（跳过公共前缀/子目录） #

S3的公共前缀（模拟的子目录）是基于delimiter参数生成的，**不设置delimiter**时，API不会返回公共前缀，只会返回所有文件对象。

代码示例：

ListObjectsV2Request request = ListObjectsV2Request.builder()
        .bucket("your-bucket-name")
        // 不配置delimiter，跳过公共前缀生成
        .build();

try (ListObjectsV2Iterable responses = s3Client.listObjectsV2Paginator(request)) {
    for (ListObjectsV2Response response : responses) {
        // 仅处理文件对象
        response.contents().forEach(s3Object -> {
            System.out.println("文件路径: " + s3Object.key());
        });
        // 此时response.commonPrefixes()为空集合
    }
}

2. 仅返回子目录（公共前缀，跳过文件） #

要只获取模拟的子目录，需设置delimiter（通常用/），配合可选的prefix指定起始路径，还可以关闭fetchOwner减少冗余返回数据。设置delimiter后，API会将同层级的前缀作为公共前缀返回，不会深入子目录返回文件。

代码示例：

ListObjectsV2Request request = ListObjectsV2Request.builder()
        .bucket("your-bucket-name")
        .delimiter("/") // 按目录分隔符分组生成公共前缀
        .prefix("target-root/") // 可选，指定要查询的起始目录路径
        .fetchOwner(false) // 不返回对象所有者信息，提升请求效率
        .build();

try (ListObjectsV2Iterable responses = s3Client.listObjectsV2Paginator(request)) {
    for (ListObjectsV2Response response : responses) {
        // 仅处理公共前缀（模拟的子目录）
        response.commonPrefixes().forEach(prefix -> {
            System.out.println("子目录路径: " + prefix.prefix());
        });
        // 此时response.contents()仅包含当前前缀下的直接文件（若存在），可直接忽略
    }
}

核心原理 #

S3本身没有真实的目录结构，所有“子目录”都是通过对象键的前缀模拟实现的。listObjectsV2的delimiter参数是控制返回内容的关键：

• 不设置delimiter：API遍历所有对象键，不做分组，仅返回文件对象列表。
• 设置delimiter：API按分隔符拆分对象键，生成同层级的公共前缀（子目录），同时仅返回当前层级的文件对象。

通过合理配置该参数，就能精准获取目标类型的数据，减少传输量并提升请求效率。

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