Cosmos DB通过slug读取Articles容器项返回No Content问题排查

从名为Articles、分区键配置为/slug的Azure Cosmos DB容器中读取单篇文章时，调用如下代码返回No Content结果，已确认容器中存在对应slug的文章，需要定位问题出在容器配置还是查询逻辑：

public async Task<Article> GetArticle(string slug)
{
    try
    {
        var response = await _container.ReadItemAsync<Article>(slug, new PartitionKey(slug));
        return response.Resource;
    }
    catch (CosmosException) // 处理项不存在及其他Cosmos相关异常
    {
        return null;
    }
}

• 核对文档id字段是否和传入参数完全匹配
  ReadItemAsync是点读操作，第一个入参必须和文档的id属性值完全一致（大小写、特殊字符全匹配），仅分区键值匹配无法命中数据。这是该类问题最常见的诱因：创建文档时如果没有手动指定id，Cosmos DB会自动生成GUID作为id值，和传入的slug自然不匹配。
  可以直接在Cosmos DB数据资源管理器执行查询SELECT c.id, c.slug FROM c WHERE c.slug = '<你传入的slug值>'，核对返回结果中id字段值是否等于传入的slug。
• 校验分区键匹配逻辑
  前往容器的规模和设置页面，先确认分区键路径确实配置为/slug，没有配成嵌套路径或者其他字段。
  再核对传入的slug值：不能有前后多余空格、大小写差异，类型必须和文档中存储的slug类型一致（比如文档中slug存为数字，你传字符串就会匹配失败）。
• 修正吞异常的逻辑定位具体错误
  现有代码直接捕获所有CosmosException返回null，完全屏蔽了真实错误原因，临时修改catch块打印错误信息即可快速定位：

  catch (CosmosException ex)
  {
      // 错误码对应问题：404=项不存在（id/分区键不匹配），403=权限/网络限制，400=请求参数格式错误
      Console.WriteLine($"错误码：{ex.StatusCode}，错误详情：{ex.Message}");
      return null;
  }
  

  • 若返回403：检查连接密钥是否有读权限，确认Cosmos DB账户的IP白名单、VNet访问规则没有拦截当前请求
  • 若返回400：检查分区键值类型、文档id格式是否合法
  • 若返回404：100%是id+分区键的组合和文档实际存储值不匹配，回到前两步逐字段核对
• 检查索引策略配置
  如果手动修改过容器索引策略，确认没有把id、slug字段排除在索引范围外，默认索引策略下不会存在该类问题。

补充说明：如果你的业务设计中slug不是文档的id，有两种修正方案：一是创建文档时手动将id字段赋值为slug值，继续保留点读的高性能优势；二是放弃点读，改用Linq查询按slug字段筛选匹配项。

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