EF Core 7 JSON列投影报错：LINQ表达式无法转换

问题原因 #

EF Core 7对JSON嵌套集合的服务器端投影支持存在局限性，当使用带[Expandable]的自定义投影方法时，EF Core无法将JsonQueryExpression（对应JSON列内的AddressList集合）转换为可执行的SQL表达式——这类自定义投影的表达式树无法被EF Core的JSON查询解析器正确处理。而Privacy字段采用关系表格式，EF Core能直接解析其投影逻辑，因此未出现报错。

解决方法 #

方法1：直接在查询Select中手动投影（推荐兼容方案） #

将原本封装在AddressesDataExpressions.Projections.Project里的投影逻辑，直接写入EF查询的Select语句中，让EF Core直接解析JSON列的投影转换：

public async Task<CustomerSettings?> GetSettingsAsync(int customerId, CancellationToken cancellationToken = default)
{
    var customerSettings = await _appDbContext.Customers
        .Where(c => c.ResourceId == customerId)
        .Select(c => new CustomerSettings
        {
            Addresses = new Addresses
            {
                PrimaryAddressIndex = c.Addresses.Primary,
                AllAddresses = c.Addresses.AddressList.Select(ad => new Address
                {
                    City = ad.City,
                    CountryCode = ad.CountryCode,
                    FirstLine = ad.FirstLine,
                    PostCode = ad.PostCode,
                    SecondLine = ad.SecondLine
                }).ToList()
            },
            Privacy = CPE.Projections.Project(c.Privacy),
            SocialMedia = new()
            {
                Facebook = c.SocialMedia.Facebook,
                Instragam = c.SocialMedia.Instragam,
                Twitter = c.SocialMedia.Twitter
            }
        })
        .FirstOrDefaultAsync(cancellationToken);

    return customerSettings;
}

方法2：启用客户端评估（小数据量场景适用） #

若必须保留自定义投影方法，可切换为客户端评估，先将数据拉取到内存再执行投影。注意：此方案会加载符合条件的完整CustomerData实体，数据量大时会影响性能：

public async Task<CustomerSettings?> GetSettingsAsync(int customerId, CancellationToken cancellationToken = default)
{
    var customer = await _appDbContext.Customers
        .Where(c => c.ResourceId == customerId)
        .FirstOrDefaultAsync(cancellationToken);

    if (customer == null)
        return null;

    return new CustomerSettings
    {
        Addresses = ADE.Projections.Project(customer.Addresses),
        Privacy = CPE.Projections.Project(customer.Privacy),
        SocialMedia = new()
        {
            Facebook = customer.SocialMedia.Facebook,
            Instragam = customer.SocialMedia.Instragam,
            Twitter = customer.SocialMedia.Twitter
        }
    };
}

方法3：升级到EF Core 8（长期最优方案） #

EF Core 8大幅优化了JSON列的查询与投影支持，包括嵌套JSON集合的服务器端投影、更灵活的表达式解析能力。升级后，现有自定义投影方法大概率可直接正常运行，无需修改代码。

补充说明 #

EF Core 7中，JSON列的OwnsMany配置虽能映射嵌套集合，但在复杂投影（尤其是自定义表达式树）场景下存在解析限制；直接在查询中编写投影逻辑是最稳妥的兼容方式。而EF Core 8对JSON的支持更贴近关系表的使用体验，能更好地处理此类场景。

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