使用HotChocolate v15.1.8、EF v9.0.7和Mapster v7.4.0时，[UseSorting]/[UseFiltering]与DDD值对象的LINQ转换冲突问题

这个问题我之前也踩过坑，本质原因是HotChocolate的筛选/排序逻辑是基于你的GQL DTO结构生成查询表达式，但EF实体里的Label是DDD值对象类型，直接访问.Value的操作无法被EF Core翻译为对应的SQL语句。下面给你几个可行的解决方案，按实用优先级排序：

方案1：为值对象配置EF Core类型转换（推荐） #

让EF Core直接把值对象Label映射为数据库中的字符串列，这样EF就能自动识别.Value对应的SQL字段，HotChocolate生成的查询自然就能被正确翻译了。

在你的AppDbContext的OnModelCreating方法里添加以下配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 为Label值对象配置EF双向转换
    modelBuilder.Entity<LegalEntity>()
        .Property(e => e.Label)
        .HasConversion(
            // 将Label转换为数据库存储的string
            label => label.Value,
            // 从数据库的string还原为Label对象（要和你的Label创建逻辑匹配）
            value => Label.Create(value).Value
        );
}

配置完成后，EF会把LegalEntity.Label当成普通字符串列处理，HotChocolate生成的l.Label.Value == __p_0表达式会被自动转换为SQL中的Label = @p0，完美解决翻译报错问题，而且完全符合DDD+EF的实践思路。

方案2：自定义HotChocolate的筛选/排序映射规则 #

如果不想修改EF的映射配置，可以手动告诉HotChocolate：当对LegalEntityGql的Label字段进行筛选/排序时，要对应到EF实体的Label.Value属性。

修改你的GraphQL服务配置：

services.AddGraphQLServer()
    .AddAuthorization()
    .AddGraphQLTypes()
    .AddProjections()
    .AddFiltering(options =>
    {
        // 针对LegalEntityGql的Label字段配置筛选映射
        options.AddFilteringType<LegalEntityGqlFilterType>(descriptor =>
        {
            descriptor.BindFieldsExplicitly();
            descriptor.Field(f => f.Label)
                .Type<StringType>()
                .Filter<StringOperationFilterInputType>()
                .ResolveFilter((entity, filter) => 
                    filter switch
                    {
                        { Eq: not null } => entity.Label.Value == filter.Eq,
                        { Contains: not null } => entity.Label.Value.Contains(filter.Contains),
                        // 可根据需求添加其他筛选操作（如StartsWith、EndsWith等）
                        _ => true
                    });
        });
    })
    .AddSorting(options =>
    {
        // 配置排序规则
        options.AddSortingType<LegalEntityGqlSortType>(descriptor =>
        {
            descriptor.BindFieldsExplicitly();
            descriptor.Field(f => f.Label)
                .ResolveSort((query, direction) => 
                    direction == SortDirection.Ascending
                        ? query.OrderBy(e => e.Label.Value)
                        : query.OrderByDescending(e => e.Label.Value));
        });
    });

这个方案需要手动映射每个筛选/排序操作，适合需要精细控制查询逻辑的场景。

方案3：调整查询顺序（先筛选再投影） #

你原来的代码是先投影到DTO再应用筛选，这会导致HotChocolate在DTO类型上生成筛选表达式。我们可以调整顺序，先对EF实体应用筛选/排序，再投影到DTO：

首先修改查询方法的返回类型为EF实体的IQueryable：

[Authorize]
[QueryType]
public class LegalEntityQueries
{
    [UseFiltering]
    [UseSorting]
    public IQueryable<LegalEntity> GetLegalEntities(
        AppDbContext dbContext,
        int? limit = null,
        int? offset = null)
    {
        return dbContext.LegalEntities
            .TakeIf(limit)
            .SkipIf(offset);
    }
}

然后通过HotChocolate的对象类型配置来做投影，保护领域模型不暴露：

[ObjectType<LegalEntity>]
public class LegalEntityGqlType
{
    public Guid Id(LegalEntity entity) => entity.Id;
    public string Label(LegalEntity entity) => entity.Label.Value;
    // 其他字段同理映射
}

这样HotChocolate会直接针对LegalEntity生成筛选/排序表达式，EF能正确翻译，同时通过ObjectType将实体转换为DTO结构，完全符合你不想暴露整个实体的需求。

总结 #

最推荐的是方案1，因为它让EF直接理解值对象的映射逻辑，不需要额外修改GraphQL配置，代码最简洁也最符合DDD的设计思路。如果有特殊约束不能修改EF映射，再考虑方案2或3。

内容来源于stack exchange