使用EF Core 6查询CosmosDB中含嵌入式实体的GraphQL请求时遇到的问题

你遇到的这个错误确实是EF Core 6.x针对Cosmos DB处理嵌套集合类型投影时的一个已知问题，本质是EF的表达式树编译逻辑在处理深层嵌套集合的投影时出现了缺陷。下面分几个方向给你解决方案：

1. 优先升级EF Core版本（最推荐） #

EF Core 7及以后的版本对Cosmos DB的查询引擎做了大幅重构，专门修复了这类嵌套集合投影的表达式编译错误。如果你的项目可以升级到EF Core 7+，这个问题大概率会直接消失，这也是最彻底的解决办法。

2. 调整查询方式绕过EF的投影翻译 #

如果暂时无法升级版本，可以通过两种方式绕过这个问题：

方式一：先加载完整实体再内存投影 #

先把Product实体完整加载到内存，再进行投影操作。这种方法适合数据量不大的场景，避免性能问题：

var products = await _context.Products
    .ToListAsync() // 先加载到内存
    .Select(p => new 
    {
        p.ProductId,
        p.ProductType,
        p.StartDate,
        p.ProductInfo,
        MarketingData = new 
        {
            Localizations = p.MarketingData.Localizations.Select(l => new 
            {
                l.LocalizationName,
                l.LocalizationType
            }).ToList()
        }
    }).ToListAsync();

方式二：使用Cosmos原生SQL查询 #

既然你提到直接用SQL查询可以正常工作，EF Core支持直接执行Cosmos的原生SQL，绕过EF的表达式翻译：

var cosmosSql = @"
SELECT 
    p.ProductId, 
    p.ProductType, 
    p.StartDate, 
    p.ProductInfo, 
    p.MarketingData.Localizations 
FROM Products p";

var products = await _context.Products
    .FromSqlRaw(cosmosSql)
    .ToListAsync();

3. 尝试ModelBuilder显式配置（效果有限） #

你可以尝试通过ModelBuilder明确配置嵌套实体的映射关系，告诉EF如何处理嵌入式集合，但要注意在EF Core 6中这不一定能解决问题，因为核心缺陷在表达式编译逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置ProductInfo为嵌入式实体
    modelBuilder.Entity<Product>()
        .OwnsOne(p => p.ProductInfo);

    // 配置MarketingData及其内部的Localizations集合
    modelBuilder.Entity<Product>()
        .OwnsOne(p => p.MarketingData, mdBuilder =>
        {
            mdBuilder.OwnsMany(md => md.Localizations);
        });
}

关于问题本质 #

这个错误属于EF Core 6对Cosmos DB提供器的固有约束（未修复的bug），EF Core 6的Cosmos查询引擎在处理包含集合的深层嵌套投影时，表达式树编译会出现变量未定义的问题。这个问题在EF Core 7及后续版本中已经被官方修复，所以升级版本是最优解。

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