Google Cloud Storage Java SDK列目录全量内容并区分文件与文件夹

blob.isDirectory() 始终返回false是GCS Java SDK的正常表现，核心原因是：
GCS本身是扁平结构的对象存储，没有原生目录概念，日常看到的文件夹分两类：

• 真实占位对象：名称以/结尾、大小为0的blob，一般是通过控制台、gsutil或手动上传生成
• 虚拟目录节点：SDK分层列举时根据对象路径前缀自动生成的节点，不存在对应的真实blob
  而isDirectory()方法仅会对第二类SDK生成的虚拟目录节点返回true，你列举到的第一类真实存在的目录占位对象本质是普通blob，调用这个方法自然会一直返回false。

如果需要递归获取目标文件夹下所有嵌套子文件夹、文件，不要加BlobListOption.currentDirectory()配置（加了之后只会返回当前层级的直接子节点，不会递归），直接按GCS目录占位符的通用规则判断类型即可，不需要依赖SDK的isDirectory()方法：

// 注意目标路径前缀必须以/结尾，避免匹配到同前缀名称的无关文件
String targetPrefix = "your/target/folder/path/";
Page<Blob> blobPage = storage.list(
        bucketName,
        BlobListOption.prefix(targetPrefix),
        // 可选：指定返回字段降低数据传输量，可根据业务需要增减字段
        BlobListOption.fields(BlobField.NAME, BlobField.SIZE, BlobField.CONTENT_TYPE, BlobField.UPDATED)
);

for (Blob blob : blobPage.iterateAll()) {
    String name = blob.getName();
    // 目录判断规则：名称以/结尾 且 大小为0
    boolean isDir = name.endsWith("/") && blob.getSize() == 0;
    
    if (isDir) {
        // 这里写文件夹的处理逻辑
        System.out.printf("目录：%s%n", name);
    } else {
        // 这里写普通文件的处理逻辑
        System.out.printf("文件：%s，大小：%d字节%n", name, blob.getSize());
    }
}

• 如果你的需求是只列举当前目录下的直接内容、不递归遍历子文件夹，可以加上BlobListOption.currentDirectory()选项，此时SDK会自动返回虚拟目录节点，isDirectory()方法可以正常生效，但这种模式需要你手动遍历拿到的子目录路径，递归调用list接口才能拿到全量内容。
• 上述判断逻辑兼容所有GCS生态工具生成的目录占位符，不会出现识别错误的问题。

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