Azure Cosmos DB跨分区创建同ID文档失败问题咨询

首先明确一点：默认情况下，Azure Cosmos DB 是允许不同分区中存在相同id的文档的，此时分区键 + id才是集合内的唯一标识。你遇到的409冲突（SubStatusCode 3302），本质是唯一键违反，大概率是你的容器被配置了全局唯一的id约束，而非默认的分区内唯一。

背后的原因拆解 #

• 默认行为：Cosmos DB 对id的唯一性限制，默认仅作用于同一个分区键对应的分区内。也就是说，只要两个文档的分区键不同，它们的id完全可以重复，不会触发冲突。
• 你的场景：从错误信息里的"Resource with id already exists with a conflicting hashed partition key"可以看出，你的容器应该配置了包含/id的全局唯一键策略。一旦设置了/id作为唯一键，Cosmos DB就会强制整个集合内的id必须唯一，不管文档属于哪个分区，这就导致了你跨分区创建相同id文档时触发409冲突。

验证与解决步骤 #

1. 检查容器的唯一键配置
   去Azure门户或者通过SDK查看你的容器的UniqueKeyPolicy，确认是否包含/id这个唯一键规则。如果存在，那就是问题根源。
2. 调整配置以匹配业务需求
   • 如果你需要跨分区使用相同id：修改唯一键策略，移除/id的全局约束，改为配置/你的分区键字段 + /id作为唯一键（或者直接不设置自定义唯一键，依赖默认的分区内id唯一逻辑）。
   • 如果你确实需要全局唯一的id：确保所有新文档的id在整个集合内都是唯一的，不管分区键是什么。

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