ADLS Gen2 List Paths REST API续接令牌调用异常问题咨询

问题根因 #

调用ADLS Gen2 List Paths接口枚举路径时拿到的两类续接令牌，不存在“某类令牌天然不可用”的区别。以==结尾的令牌传入后报错的核心原因是：
==是Base64编码的标准填充字符，属于URI查询参数的保留字符，如果直接把原始令牌字符串拼接到URI中不做编码，服务端解析URI时会把=识别为参数键值的分隔符，最终拿到残缺的令牌值，直接返回参数错误。
此前流传的“跳过带==的令牌重复请求直到拿到无后缀令牌”的方案属于规避方案，没有解决根本问题，大目录枚举时会产生大量无效请求，触发存储账号限流，还可能出现数据遗漏。

最优处理方案 #

• 所有从响应头x-ms-continuation字段获取的续接令牌，无论是否带==后缀，传入下一次请求前必须做URL百分号编码，禁止直接拼接原始令牌字符串到URI中。
  示例中带==的令牌LCJhbGciOiJSUzI1NiIsIng1dCI6ImpTMVhvMU9XRGpfNTJ2Ynd==编码后，=会被转义为%3D，最终传入的参数值为LCJhbGciOiJSUzI1NiIsIng1dCI6ImpTMVhvMU9XRGpfNTJ2Ynd%3D%3D，服务端可正常解析，不会返回错误。
• 禁止手动裁剪令牌末尾的==填充位，禁止跳过带==的令牌重复发起请求：裁剪填充位会导致令牌携带的游标信息损坏，枚举时会出现重复返回路径、遗漏路径的问题；重复发起无令牌请求会产生大量无效调用，在文件量级较大时极容易触发服务端限流，大幅拉低枚举效率。

标准全量枚举流程 #

• 首次请求构造：按业务需求传入recursive、maxresults参数，固定传入resource=filesystem，首次请求不需要携带continuation参数，所有参数拼接时统一做URL编码。
• 响应处理：每次请求收到响应后，先检查响应头是否存在x-ms-continuation字段：如果该字段不存在，说明已经枚举完全量路径，直接终止流程。
• 续传请求构造：如果响应头存在续接令牌，对令牌值做URL编码后，作为continuation参数传入下一次请求，不需要额外判断令牌格式。
• 循环执行上述响应处理、续传请求构造步骤，直到响应头无续接令牌为止。

正确的带续接令牌的请求格式示例：

GET https://storageAccountName.dfs.core.windows.net/sampleDirectory?recursive=true&resource=filesystem&maxresults=1000&continuation=LCJhbGciOiJSUzI1NiIsIng1dCI6ImpTMVhvMU9XRGpfNTJ2Ynd%3D%3D

实操提示：尽量使用成熟HTTP客户端自带的查询参数构造方法传递参数，不要手动拼接URI字符串。主流HTTP客户端的参数构造方法会自动对参数值做URL编码，可以从根源上避免这类编码问题。

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