Azure Cosmos DB设置/user/firstName为分区键后读取报错求助

你的JSON数据结构如下：

{
  "user": {
    "firstName": "FirstName"
  },
  "attr1": "abcd",
  "attr2": "efgh"
}

你将容器分区键设置为/user/firstName，但使用以下代码读取时出现未找到异常：

var firstName = "FirstName"
User user= await _container.ReadItemAsync<User>(firstName, new PartitionKey(firstName));

问题原因 #

ReadItemAsync的第一个参数是文档的ID，不是分区键。你现在把firstName当作ID传入，但你的JSON里没有显式指定id字段（Cosmos DB会自动生成随机ID），所以用firstName作为ID查找自然找不到对应文档。分区键的传入是正确的，但ID参数错误是核心问题。

解决方案 #

分两种场景处理：

• 场景1：把user.firstName同时作为ID和分区键
  写入文档时手动设置id字段为firstName的值，修改后的JSON如下：

  {
    "id": "FirstName",
    "user": {
      "firstName": "FirstName"
    },
    "attr1": "abcd",
    "attr2": "efgh"
  }
  

  此时你的读取代码可以保持不变（ID和分区键值一致）。

• 场景2：保留自动生成的ID或使用其他字段作为ID
  必须获取文档的实际ID值，将其作为第一个参数传入ReadItemAsync，分区键仍用firstName，示例代码：

  // 替换为文档实际的ID值
  string docId = "xxxx-xxxx-xxxx";
  var firstName = "FirstName";
  User user = await _container.ReadItemAsync<User>(docId, new PartitionKey(firstName));
  

额外说明 #

• Cosmos DB的ReadItemAsync必须同时提供正确的文档ID和匹配的分区键值才能精准定位文档，两者缺一不可。
• 如果不知道文档ID，可以先通过查询获取，示例代码：

  var firstName = "FirstName";
  var query = _container.GetItemQueryIterator<User>(
      $"SELECT * FROM c WHERE c.user.firstName = @firstName",
      requestOptions: new QueryRequestOptions { PartitionKey = new PartitionKey(firstName) }
  );
  var results = await query.ReadNextAsync();
  var user = results.FirstOrDefault();
  

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