使用REST API创建Cosmos DB文档时分层分区键报错问题

问题根源 #

使用分层分区键（比如/id、/date）时，手动设置x-ms-documentdb-partitionkey-kind: HASH会触发错误——因为分层分区键默认是MultiHash类型，REST API不需要你显式指定这个参数，强行设置HASH反而会和自动识别的类型冲突。

正确操作步骤 #

• 删掉x-ms-documentdb-partitionkey-kind请求头：Cosmos DB会自动识别分层分区键的类型，不需要手动指定。
• 确保分区键参数格式正确：x-ms-documentdb-partitionkey的值严格按分区键顺序传数组，比如你的分区键是/id在前、/date在后，就传["id对应值", "date对应值"]，还要保证参数值的类型和文档里的字段类型一致（比如date是字符串就传字符串，别传日期对象）。

额外检查项 #

• 确认目标容器的分区键确实是/id、/date的分层配置，没搞反顺序。
• 检查请求URL是否正确指向该容器，没有写错数据库或容器名称。

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