升级Cosmos DB客户端SDK后，旧continuation token是否失效？

核心结论 #

Cosmos DB服务端通常兼容不同SDK版本生成的continuation token，仅在极少数重大API变更场景下可能出现不兼容情况。

详细说明 #

• Continuation token本质是Cosmos DB服务端生成的序列化分页标记，SDK仅负责传递和解析，核心逻辑由服务端管控。
• 官方文档提到的“相同版本SDK下token永不过期”，重点是同版本SDK解析token不会出错，但服务端本身对旧SDK生成的token大多保持向后兼容。
• 极端例外：若SDK升级涉及服务端API的重大废弃（比如token依赖的旧API字段被移除），旧token可能无法被识别，但这类情况微软会提前公告，且非常少见。
• 对应你描述的场景：客户端携带旧SDK生成的token调用升级了新版SDK的API时，只要新版SDK使用的是服务端支持的API版本，服务端会正常接受该token并返回对应下一页数据。

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