如何通过Java API删除Google Cloud Storage（GCS）中启用分层命名空间的空目录？

这个问题的核心在于：启用分层命名空间（HNS）的GCS桶中，文件夹是实际存在的独立资源，而你当前使用的是针对Blob（文件）的API方法，无法正确识别和操作Folder（文件夹）资源。下面是具体的解决方案：

1. 为什么之前的代码失效？ #

• 当你创建dir/foo时，GCS HNS会自动生成dir/这个独立的Folder资源，但storage.list()方法默认只返回Blob对象，所以删除文件后，空Folder仍然存在，但你的Blob列表查询看不到它
• storage.delete("dir/")尝试删除名为dir/的Blob，但这个Blob根本不存在（dir/是Folder资源，不是Blob），所以返回false

2. 正确的解决方案：使用Folder专属API #

GCS Java SDK针对HNS桶的Folder资源提供了专门的操作方法，你需要切换到这些方法来处理空文件夹：

2.1 列出所有文件夹（包括空的） #

用listFolders()方法替代list()，可以获取桶中的所有Folder资源，不管是否为空：

// 列出桶中的所有文件夹
storage.listFolders(TEST_BUCKET_NAME)
    .forEach(folder -> System.out.println(folder.getName())); // 删除文件后仍会输出 dir/

2.2 删除空文件夹 #

使用deleteFolder()方法来删除Folder资源，这会正确识别HNS桶中的空文件夹：

// 删除指定的空文件夹
boolean isDeleted = storage.deleteFolder(TEST_BUCKET_NAME, "dir/");
if (isDeleted) {
    System.out.println("空文件夹已成功删除");
}

2.3 递归删除带内容的文件夹 #

如果文件夹下还有文件或子文件夹，可以添加递归选项一次性删除所有内容：

// 递归删除文件夹及其所有子资源
storage.deleteFolder(TEST_BUCKET_NAME, "dir/", Storage.DeleteFolderOption.recursive());

3. 验证效果 #

修改你的代码后，删除文件后的流程应该是这样的：

// 删除文件后，列出空文件夹
storage.listFolders(TEST_BUCKET_NAME)
    .forEach(folder -> System.out.println(folder.getName())); // 输出 dir/

// 删除空文件夹
boolean deleted = storage.deleteFolder(TEST_BUCKET_NAME, "dir/"); // 返回 true

这样就能和gcloud storage rm -r gs://<myBucketName>/dir或控制台操作达到一样的效果了。

备注：内容来源于stack exchange，提问作者Oliv