Cosmos Java SDK抛出x-ms-substatus=10003异常，寻求排查经验

10003子状态码的本质 #

10003是客户端SDK的Global Client Throughput Control特性触发限流时生成的内部子状态码，不属于Cosmos DB服务端返回的标准429子状态码范畴，因此不会出现在微软公开的服务端故障排查文档中。

你在测试中遇到该状态，说明客户端侧的限流逻辑已经生效，正在主动限制写入请求的发送速率，避免触发服务端的RU预算耗尽限流。

官方公开的429子状态码参考 #

根据微软故障排查指南，服务端返回的429相关子状态码及含义如下：

// 429: 请求速率过大
RUBudgetExceeded = 3200,            // 已消耗分配的RU资源
GatewayThrottled = 3201,            // 网关层限制请求量
StoredProcedureConcurrency = 3084   // 达到存储过程并发限制

测试场景下的调整建议 #

• 若测试目标是验证客户端限流的有效性，当前状态符合预期，无需调整
• 若需模拟服务端限流场景，可适当调大Global Client Throughput Control的限流阈值，让请求能够到达服务端并触发3200子状态码

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