如何排查Cosmos NoSQL中触发的唯一索引约束违规项？

方法1：解析SDK异常的原始响应内容 #

触发唯一键冲突时，SDK抛出的异常里藏着具体的违规键信息，只是默认错误提示没显示出来：

• 用.NET SDK的话，捕获CosmosException，调用await exception.ResponseMessage.Content.ReadAsStringAsync()拿到完整的错误JSON，里面的errors数组中，message字段会明确指出违规的唯一键路径（比如Unique index constraint violated for index path '/username'）。
• 用Python/Java/Node.js等其他SDK时，同样捕获对应异常，提取原始响应体，就能找到带具体键名的错误描述。

方法2：开启模拟器的详细日志 #

Docker版Cosmos模拟器可以通过配置环境变量输出更详细的错误日志：

• 启动模拟器时添加AZURE_COSMOS_EMULATOR_LOG_LEVEL=Debug环境变量，示例启动命令：

  docker run -p 8081:8081 -p 10250-10255:10250-10255 -e AZURE_COSMOS_EMULATOR_LOG_LEVEL=Debug mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator
  

• 之后用docker logs <你的模拟器容器名>查看日志，里面会直接记录触发冲突的唯一键名称。

方法3：通过模拟器Web UI查看原始响应 #

打开模拟器内置的Web Explorer（默认地址https://localhost:8081/_explorer/index.html），执行插入操作后，在请求的原始响应区域里，能看到包含具体违规键的完整错误信息。

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