HotChocolate 13.5.0自定义过滤器失效，求助文档与代码示例

问题场景 #

在HotChocolate中为SampleTest类型创建自定义过滤器：

1. 继承FilterInputType<SampleTest>并添加自定义过滤字段testKind
2. 为该字段指定继承自QueryableOperationHandlerBase的自定义处理器TestKindFilterHandler
3. 已将处理器配置到过滤约定中，但处理器完全未生效，既不进入CanHandle逻辑，也不执行HandleOperation
4. 尝试更换HotChocolate基类、参考官方源码示例后仍未解决，需要可运行的代码示例与实现说明

现有代码核心问题分析 #

1. CanHandle判断逻辑错误：原代码中return context is TestKindFilterType的类型转换不成立，ITypeCompletionContext并非TestKindFilterType的实例，导致处理器被判定为无法处理该字段
2. 处理器实例化方式错误：手动new TestKindFilterHandler(new InputParser())绕过了HotChocolate的依赖注入系统，且不符合框架的处理器注册逻辑
3. 输入类型定义不规范：TestKindFilterType作为过滤输入类型，未明确关联过滤操作（如eq），框架无法识别其为过滤操作类型
4. 表达式构建不符合EF查询要求：使用Enumerable.Any会导致客户端内存过滤，而非数据库端查询，且手动创建参数的方式不符合HotChocolate的上下文参数管理

修正后的完整代码示例 #

1. 过滤器输入类型定义 #

// 自定义过滤输入类型，明确过滤操作（如eq）
public class TestKindFilterInput : InputObjectType
{
    protected override void Configure(IInputObjectTypeDescriptor descriptor)
    {
        descriptor.Name("TestKindFilter");
        // 定义等于操作，可根据需求添加contains、in等其他操作
        descriptor.Field("eq").Type<StringType>();
    }
}

2. 自定义过滤器类型 #

public class SampleTestFilter : FilterInputType<SampleTest>
{
    protected override void Configure(IFilterInputTypeDescriptor<SampleTest> descriptor)
    {
        base.Configure(descriptor);

        // 绑定自定义处理器，而非手动实例化
        descriptor.Field("testKind")
                  .Type<TestKindFilterInput>()
                  .BindHandler<TestKindFilterHandler>();
    }
}

3. 修正后的自定义处理器 #

public class TestKindFilterHandler : QueryableOperationHandlerBase
{
    public TestKindFilterHandler(InputParser inputParser) : base(inputParser)
    {
    }

    // 正确判断是否能处理该字段：匹配字段名或输入类型
    public override bool CanHandle(ITypeCompletionContext context, IFilterInputTypeDefinition typeDefinition, IFilterFieldDefinition fieldDefinition)
    {
        return fieldDefinition.Name.Equals("testKind", StringComparison.OrdinalIgnoreCase) 
               || context.Type is TestKindFilterInput;
    }

    public override Expression HandleOperation(QueryableFilterContext context, IFilterOperationField field, IValueNode value, object? parsedValue)
    {
        // 从上下文获取当前实体参数，无需手动创建
        var entityParam = context.GetParameter();
        // 获取SampleTest的Parameters属性
        var parametersProperty = Expression.PropertyOrField(entityParam, nameof(SampleTest.Parameters));

        // 构建针对AccountingParameterBase的谓词
        var param = Expression.Parameter(typeof(AccountingParameterBase), "p");
        // 使用EF.Property访问阴影属性_wrappedValue
        var wrappedValue = Expression.Call(
            typeof(EF), 
            nameof(EF.Property), 
            new[] { typeof(object) }, 
            param, 
            Expression.Constant("_wrappedValue"));
        
        // 访问_wrappedValue中的_valueString阴影属性
        var valueString = Expression.Call(
            typeof(EF), 
            nameof(EF.Property), 
            new[] { typeof(string) }, 
            wrappedValue, 
            Expression.Constant("_valueString"));
        
        // 根据操作类型构建比较表达式（这里以eq为例）
        Expression comparison = field.Name switch
        {
            "eq" => Expression.Equal(valueString, Expression.Constant(parsedValue)),
            // 可扩展其他操作，比如contains
            "contains" => Expression.Call(valueString, nameof(string.Contains), null, Expression.Constant(parsedValue)),
            _ => throw new NotSupportedException($"操作 {field.Name} 未实现")
        };

        var innerPredicate = Expression.Lambda<Func<AccountingParameterBase, bool>>(comparison, param);

        // 使用Queryable.Any实现数据库端的存在性查询
        var anyCall = Expression.Call(
            typeof(Queryable), 
            nameof(Queryable.Any), 
            new[] { typeof(AccountingParameterBase) }, 
            parametersProperty, 
            innerPredicate);

        return anyCall;
    }
}

4. 服务配置（注册过滤器与处理器） #

// 在Program.cs中配置GraphQL服务
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<YourDbContext>(options =>
{
    // 配置你的数据库连接
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection"));
});

builder.Services.AddGraphQLServer()
    .AddFiltering(options =>
    {
        options.AddDefaultOperations();
        // 注册自定义处理器到过滤约定中
        options.AddOperationHandler<TestKindFilterHandler>();
    })
    .AddQueryType<Query>()
    // 注册自定义过滤器类型
    .AddType<SampleTestFilter>();

var app = builder.Build();

app.MapGraphQL();
app.Run();

关键注意事项 #

• 处理器必须通过约定注册：必须使用AddOperationHandler将处理器添加到过滤配置中，不能手动实例化赋值，否则框架无法识别并调用处理器
• CanHandle逻辑要准确：需基于字段名、输入类型等明确标识处理器可处理的场景，避免错误的类型判断
• EF查询使用Queryable方法：所有针对数据库的查询操作需使用System.Linq.Queryable下的静态方法，确保查询在数据库端执行而非客户端内存过滤
• 输入类型需关联操作：自定义过滤输入类型需明确定义支持的操作（如eq、contains），框架才能将查询映射到对应的处理器逻辑

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