Azure Blob Storage API仅返回5000条数据，无NextMarker问题排查

出现这种情况的核心原因通常和存储账户的分层命名空间配置或API请求参数的设置有关，以下是具体排查点和解决方法：

1. 检查存储账户是否启用了分层命名空间（ADLS Gen2） #

如果你的存储账户开启了分层命名空间（即ADLS Gen2类型），传统的GET /mycontainer?restype=container&comp=list API默认只会列出容器根目录下的直接子项（包括blobs和子目录），不会递归遍历所有子目录中的文件。而Azure UI的“计算大小”功能会统计所有层级的条目总数，这就导致UI显示>20000条，但API只返回根目录的5000条（刚好达到单次返回上限），因此没有NextMarker。

解决方法： #

• 改用ADLS Gen2专属的List Paths API，请求格式为：

  GET /mycontainer?resource=filesystem&comp=list&recursive=true
  

  加上recursive=true参数后，会递归返回所有层级的文件和目录，当结果超过5000条时，会正常返回NextMarker用于分页。
• 若坚持使用传统List Blobs API，需要通过遍历每个子目录（结合prefix参数）来逐个获取子目录下的blobs。

2. 检查API请求中的delimiter参数 #

如果你的请求中添加了delimiter=/参数，API会按目录分组返回结果，只展示根目录下的blobs和子目录，不会递归列出所有层级的内容。如果根目录的直接子项刚好有5000个，就会返回5000条且无NextMarker。

解决方法： #

• 移除delimiter参数，或者将其设为空字符串，这样API会返回所有层级的blobs。当总条目超过5000时，会自动返回NextMarker，你可以在下一次请求中带上marker=<返回的NextMarker值>参数来获取下一页结果。

补充说明 #

Azure Blob存储的List类API单次返回结果的上限是5000条，这是服务端的硬限制，无法修改。只要总条目超过5000且API请求正确配置了递归/全量查询，就会返回NextMarker用于分页续查。

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