如何用Java列出Azure存储账户空容器？listBlobs权限异常排查

你遇到的403错误核心是操作权限不匹配：

• containerClient.exists() 仅需容器的「读取元数据」权限，你的凭证刚好具备该权限，所以能正常返回结果。
• 而 listBlobs() 操作需要「列出Blob」权限，当前凭证未被授予该权限，因此触发了AuthorizationPermissionMismatch错误（错误提示里的签名不匹配只是通用引导，实际核心是权限不足）。

解决办法 #

1. 补充「列出Blob」权限 #

你使用的DefaultAzureCredential属于Azure AD身份验证，需要给对应的身份（服务主体、托管标识等）分配包含List Blobs权限的角色：

• 可选内置角色：Storage Blob Data Contributor（包含Blob全生命周期管理权限）
• 自定义角色：仅包含Microsoft.Storage/storageAccounts/blobServices/containers/blobs/list/action权限的最小权限角色

2. 优化空容器判断逻辑（更高效） #

即使权限足够，默认的listBlobs()会遍历所有Blob元数据，效率偏低。可以通过设置查询选项，仅请求1条结果来快速判断：

var defaultCredential = new DefaultAzureCredentialBuilder().build();

var containerClient = new BlobContainerClientBuilder()
              .endpoint("https://storageaccount.blob.core.windows.net/testcontainer") // 移除末尾斜杠，避免URL解析异常
              .credential(defaultCredential)
              .buildClient();

// 配置查询选项：仅返回1条Blob结果
BlobListDetails details = new BlobListDetails();
ListBlobsOptions options = new ListBlobsOptions()
        .setDetails(details)
        .setMaxResultsPerPage(1);

// 快速判断是否存在Blob
boolean isEmpty = containerClient.listBlobs(options, Duration.ofSeconds(30)).stream().findAny().isEmpty();

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