Azure Cosmos DB .NET v3 Linq添加Where条件返回空结果如何解决

出现加Where条件返回空、不加能返回数据的问题，核心是过滤条件与Cosmos DB实际存储的数据结构/字段不匹配，或序列化配置不一致导致，可按以下步骤排查解决：

1. 先验证基础数据是否符合预期 #

• 运行不加Where的查询，打印返回条目的IsContainer属性值，确认确实存在该属性为true的条目
• 进入Azure门户Cosmos DB对应容器的数据资源管理器，针对目标分区执行原生SQL查询（注意字段名大小写和实际存储一致）：

  SELECT * FROM c WHERE c.isContainer = true
  

  如果该查询能返回数据，说明是.NET端的属性映射与序列化配置问题。

2. 对齐SDK序列化配置 #

Cosmos DB .NET v3 SDK的Linq查询生成的过滤谓词，完全依赖初始化客户端时的序列化配置，如果存储的JSON字段为驼峰命名（行业通用默认配置），需要保证序列化配置全局对齐：

用System.Text.Json序列化的配置示例 #

CosmosClient client = new CosmosClient("你的连接串", new CosmosClientOptions
{
    Serializer = new CosmosSystemTextJsonSerializer(new JsonSerializerOptions
    {
        PropertyNamingPolicy = JsonNamingPolicy.CamelCase
    })
});

用Newtonsoft.Json序列化的配置示例 #

CosmosClient client = new CosmosClient("你的连接串", new CosmosClientOptions
{
    Serializer = new NewtonsoftJsonCosmosSerializer(new JsonSerializerSettings
    {
        ContractResolver = new CamelCasePropertyNamesContractResolver()
    })
});

如果不想修改全局配置，也可以直接在Item类的属性上加特性指定字段名：

// System.Text.Json用这个
[JsonPropertyName("isContainer")]
// Newtonsoft.Json用这个
// [JsonProperty("isContainer")]
public bool IsContainer { get; set; }

3. 调试Linq生成的原生SQL #

你可以打印Linq生成的原生SQL，直接验证过滤条件是否符合预期：

var queryable = container.GetItemLinqQueryable<Item>(requestOptions: queryRequestOptions)
    .Where(x => x.IsContainer);
// 获取生成的SQL语句
string generatedSql = queryable.ToQueryDefinition().QueryText;

如果生成的SQL里过滤条件是root["IsContainer"] = true（首字母大写），和实际存储的isContainer（首字母小写）不一致，修改序列化配置后即可解决。

4. 可空属性适配 #

如果你的IsContainer定义为可空布尔bool?，建议把过滤条件写为更明确的.Where(x => x.IsContainer == true)，避免隐式转换导致的逻辑偏差。

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