使用OData框架结合DTO时LINQ表达式无法翻译的问题

问题根源 #

核心问题是OData EDM模型中类型注册混乱，同时在DTO映射时混用了实体类与DTO类，导致OData无法正确解析LINQ表达式，进而生成错误的查询语句。即使注释掉Items的映射，EDM中已注册的实体类Item仍会和DTO的导航属性产生冲突。

具体解决方案 #

1. 统一使用DTO类，避免实体类与DTO混用

为关联对象定义对应的DTO，不要直接在OrdersDTO中使用实体类Item：

// 订单DTO
public class OrdersDTO
{
    public string OrderId { get; set; }
    public List<ItemDTO>? Items { get; set; }
}

// 商品DTO
public class ItemDTO
{
    public string ItemId { get; set; }
    public string ItemType { get; set; }
}

2. 正确配置OData EDM模型

只在EDM中注册DTO类，不要同时注册实体类（Orders、Item），并显式配置导航属性关联：

var builder = new ODataConventionModelBuilder();
// 注册订单DTO的实体集
builder.EntitySet<OrdersDTO>("Orders");
// 注册商品DTO的实体类型
builder.EntityType<ItemDTO>();
// 显式指定OrdersDTO与ItemDTO的导航关系（自动识别失效时手动配置）
builder.EntityType<OrdersDTO>().HasMany(dto => dto.Items);

3. 修改查询投影逻辑

查询时映射到对应的DTO类，并且不要在投影中使用ToList()（会破坏OData的延迟加载与SQL转换能力）：

_db.Orders.Select(o => new OrdersDTO
{
    OrderId = o.OrderId,
    Items = o.Items.Select(i => new ItemDTO
    {
        ItemId = i.ItemId,
        ItemType = i.ItemType
    }).AsQueryable()
})

关键注意事项 #

• 禁止在EDM模型中同时注册实体类和对应DTO类，否则OData会混淆类型解析逻辑，引发表达式转换错误。
• 确保DTO的导航属性类型与EDM中注册的类型完全一致，比如OrdersDTO的Items必须是List<ItemDTO>而非List<Item>。
• 投影中使用AsQueryable()替代ToList()，保留OData将LINQ表达式转换为SQL查询的能力，同时支持$expand等OData查询选项。

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