CosmosDB调用read方法返回resource undefined，404但文档存在

核心问题 #

你调用read方法时返回404，resource输出为undefined，但文档确实存在，问题出在分区键参数传递错误。

错误原因 #

你的代码中this.partitionKey = '/id'，并将这个路径字符串传给了container.item的第二个参数。但item方法的第二个参数要求传入的是分区键的实际值，而非分区键的路径（/id是容器定义时的路径配置，不是文档的分区键值）。Cosmos DB会根据你传入的/id去匹配分区键值，自然找不到目标文档，返回404。

修正后的代码 #

假设你的容器分区键路径是/id（即文档的id字段作为分区键），只需将文档的id值同时作为item方法的第二个参数传入：

this.cosmos = new CosmosClient({
  endpoint: '',
  key: '' // 原代码漏了逗号，建议补上避免语法错误
});

this.container = this.cosmos.database('test').container('test');

type Data = {
  value: string;
} & ItemDefinition;

// 第二个参数传入文档的id值（即key变量），而非分区键路径
const { resource } = await this.container.item(key, key).read<Data>();

console.log('>>>', JSON.stringify(resource));

额外检查点 #

• 确认容器的分区键配置确实为/id，避免和实际设置不符。
• 如果分区键是其他字段（比如category），则第二个参数要传入目标文档的category字段值，而非/category。
• 验证key变量是否为目标文档的正确id，排除id传错的情况。

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