Java中如何使用特定文件夹的SAS令牌创建Blob客户端并遍历内容？

问题根源 #

你遇到的两个问题原因很明确：

• 使用BlobServiceClient未授权：因为你的SAS令牌仅针对特定文件夹，权限范围不足以操作整个Blob服务。
• BlobContainerClient连接字符串无效：连接字符串里不能直接包含文件夹路径，该客户端的连接目标是容器层级，而非容器下的子文件夹。

正确实现方式 #

方式一：用BlobContainerClient + 文件夹前缀遍历 #

这是最直接的方案，步骤如下：

1. 修正连接字符串，只指向容器层级，格式如下：
   "https://{blobacct}.blob.core.windows.net/{container}?sp=..."
   确保你的SAS令牌拥有该容器下目标文件夹的访问权限，且包含list权限。
2. 创建客户端后，通过指定前缀来遍历目标文件夹下的内容：

// 构建容器客户端
BlobContainerClient containerClient = new BlobContainerClientBuilder()
    .connectionString("https://{blobacct}.blob.core.windows.net/{container}?sp=...")
    .build();

// 遍历目标文件夹下的所有内容（包含子文件夹）
for (BlobItem blobItem : containerClient.listBlobsByHierarchy("{folder}/", true)) {
    if (blobItem.isPrefix()) {
        // 处理子文件夹
        System.out.println("子文件夹路径：" + blobItem.getPrefix());
    } else {
        // 处理Blob文件
        System.out.println("Blob文件路径：" + blobItem.getName());
    }
}

关键注意事项 #

• 确认SAS令牌的sp参数包含list权限，否则无法执行遍历操作。
• Azure Blob存储中的“文件夹”是虚拟概念，本质是Blob名称的前缀，所以遍历需通过前缀筛选实现。
• 不要在连接字符串中加入文件夹路径，所有针对文件夹的操作都通过前缀参数控制。

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