使用Azure Blob Storage Java SDK分页查询时，空续令牌返回无结果求助

问题根源 #

你使用的Azure Storage Blob SDK 12.7.0中，iterableByPage(C continuationToken, int preferredPageSize)这个重载方法的设计逻辑是仅支持传入有效的续令牌来续接分页。当你传入null作为初始续令牌时，方法直接返回空结果，这是该版本API的设计限制。

解决方案 #

1. 使用无续令牌的分页重载方法 #

初始获取第一页数据时，调用仅接收preferredPageSize参数的iterableByPage重载，该方法会自动返回第一页数据，并允许你从返回的PagedResponse中获取下一页的续令牌。

示例代码：

String continuationToken = null;
BlobContainerClient blobContainerClient = blobServiceClient.getBlobContainerClient(containerNameToSearchIn);

// 初始调用：指定每页10条数据，获取第一页
Iterable<PagedResponse<BlobItem>> pagedIterable = blobContainerClient.listBlobsByHierarchy(prefix)
        .iterableByPage(10);

for (PagedResponse<BlobItem> page : pagedIterable) {
    // 处理当前页的Blob文件
    for (BlobItem item : page.getElements()) {
        // 你的业务逻辑，比如打印Blob名称
        System.out.println(item.getName());
    }
    
    // 获取下一页的续令牌
    continuationToken = page.getContinuationToken();
    
    // 若续令牌为空，说明已无更多数据
    if (continuationToken == null) {
        break;
    }
    
    // 后续分页：使用续令牌获取下一页
    Iterable<PagedResponse<BlobItem>> nextPagedIterable = blobContainerClient.listBlobsByHierarchy(prefix)
            .iterableByPage(continuationToken, 10);
    // 处理后续页逻辑...
}

2. 升级SDK版本（推荐） #

12.7.0是较早期的SDK版本，后续的稳定版本（如12.10.x及以上）优化了分页API的设计，允许在传入null续令牌时正常返回第一页数据。如果你可以升级依赖，修改pom.xml中的版本号即可：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-storage-blob</artifactId>
    <version>12.25.0</version> <!-- 替换为最新稳定版本 -->
</dependency>

升级后，你原来的代码逻辑即可正常工作，无需修改调用方式。

关键说明 #

• 低版本SDK中，带续令牌的分页方法仅用于续接已开始的分页流程，初始分页必须使用无续令牌的重载；
• 升级SDK不仅能解决这个问题，还能获得更多功能优化和Bug修复。

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