创建Azure Cosmos DB(MongoDB API)文档时遇400错误：缺少分片键？

你遇到的这个情况确实有点让人困惑——明明已经把wordpress_id设为分片键，插入的文档里也包含这个字段，却还是触发了分片键缺失的报错。我帮你梳理几个最可能的原因和对应的排查/解决方法：

1. 分片键的字段名是否完全匹配（包括大小写）？ #

MongoDB（以及Cosmos DB的MongoDB API）对字段名是大小写敏感的。举个例子：如果创建集合时你把分片键定义为WordPress_Id（带大写字母），但插入的文档里用的是全小写的wordpress_id，系统会判定这是两个完全不同的字段，自然识别不到分片键。

解决步骤：

• 登录Azure门户，进入你的Cosmos DB账户，找到目标集合的「Scale & Settings」标签页，仔细核对分片键的字段名，确保和你插入文档中的字段名完全一致（包括大小写、下划线、拼写）。
• 插入文档时严格使用和分片键定义完全相同的字段名，不要做任何大小写或拼写的改动。

2. 是否插入到了错误的集合/数据库？ #

有时候我们会不小心犯低级错误：比如连接到了其他数据库，或者插入到了另一个没有配置wordpress_id为分片键的集合里（比如你可能创建了两个同名集合，分别在不同数据库下）。

解决步骤：

• 确认Azure门户中你查看分片键的集合，和你插入文档时的目标集合是同一个。可以通过集合的名称、所在数据库来交叉验证。
• 如果是通过代码插入，检查连接字符串中的数据库名称，以及代码里指定的集合名称是否和你配置分片键的集合完全一致。

3. 分片键的配置是否真的生效了？ #

虽然你说在「Scale & Settings」里看到了分片键，但偶尔会因为操作失误或网络延迟，导致分片键配置没有正确保存到集合中。

解决步骤：

• 重新进入集合的「Scale & Settings」页面，确认「Shard key」字段确实显示为wordpress_id，且没有为空或显示其他字段。
• 尝试插入一个极简的测试文档，确保字段名100%匹配：

  { "wordpress_id": "test-key-001" }
  

  如果这个测试文档还是报错，大概率是分片键的配置有问题。

4. 注意：集合创建后无法修改分片键 #

如果以上排查都没问题，还有一种极端情况：你可能在创建集合后修改过分片键的想法，但Cosmos DB MongoDB API的集合一旦创建，分片键是无法修改的。如果之前的集合分片键不是wordpress_id，后续的修改操作其实不会生效，只能重新创建集合并设置正确的分片键。

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