OData 8+NET6下CosmosDB嵌套属性使用any运算符报错的解决咨询

问题背景 #

在使用OData 8和.NET 6框架时，针对嵌套数组属性使用any过滤运算符会抛出错误：

Microsoft.Azure.Cosmos.Linq.DocumentQueryException: Expression with NodeType 'Conditional' is not supported

JSON数据结构如下：

[
{
  "id":1,
  "vessel":{
    "classes":[
      {
        "name":"a"
      },
      {
        "name":"b"
     ]
  }
},
{
  "id":2,
  "vessel":{
    "classes":[
      {
        "name":"c"
      }
     ]
  }
}
]

使用根层级数组时MyData?$filter=classes/any(x: x/name eq 'a')可正常查询，但嵌套路径MyData?$filter=vessel/classes/any(x: x/name eq 'a')报错。

解决方案 #

1. 确保实体模型与OData配置正确 #

首先检查实体类的属性定义，确保嵌套集合属性被正确标记为可枚举类型，同时在OData模型构建时显式配置复杂类型：

实体类定义

public class MyData
{
    public int id { get; set; }
    public Vessel vessel { get; set; }
}

public class Vessel
{
    public ICollection<Class> classes { get; set; } = new List<Class>();
}

public class Class
{
    public string name { get; set; }
}

OData模型构建

public IEdmModel GetEdmModel()
{
    var builder = new ODataConventionModelBuilder();
    builder.EntitySet<MyData>("MyData");
    // 显式注册嵌套的复杂类型
    builder.ComplexType<Vessel>();
    builder.ComplexType<Class>();
    return builder.GetEdmModel();
}

2. 过滤语句中增加null检查 #

如果vessel字段可能为null，OData转换时会生成Conditional类型的表达式（用于处理null访问），而Cosmos DB LINQ提供程序不支持该类型节点。修改过滤语句，先确保vessel不为null：

MyData?$filter=vessel ne null and vessel/classes/any(x: x/name eq 'a')

3. 手动构建Cosmos LINQ查询 #

若OData自动转换仍有问题，可在控制器中手动处理查询选项，构建Cosmos支持的LINQ表达式：

[HttpGet]
public async Task<IActionResult> Get(ODataQueryOptions<MyData> options)
{
    var container = _cosmosClient.GetContainer("YourDbName", "YourContainerName");
    var query = container.GetItemLinqQueryable<MyData>();

    // 针对嵌套any的场景手动构建过滤条件
    if (options.Filter != null)
    {
        // 示例：动态条件可通过解析ODataFilter表达式实现，此处为静态示例
        query = query.Where(d => d.vessel != null && d.vessel.classes.Any(c => c.name == "a"));
    }

    var result = await query.ToListAsync();
    return Ok(result);
}

4. 升级Cosmos DB SDK版本 #

旧版本的Microsoft.Azure.Cosmos SDK对嵌套集合的LINQ表达式支持有限，检查并升级到兼容.NET 6的最新稳定版本（推荐3.30+）。

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