HotChocolate 12中为GraphQL扩展字段设置虚拟筛选处理器

错误原因 #

你在UserFilterInput中添加了listing筛选字段，但HotChocolate无法找到对应的筛选处理器。这是因为listing是通过DataLoader从外部数据源加载的扩展属性，并非User实体的原生数据库字段，默认筛选机制无法将该字段的筛选条件转换为对User数据源的查询语句。

解决方案 #

通过以下步骤手动处理扩展属性的筛选逻辑：

1. 修改FilterInput配置，标记字段为手动处理 #

在UserFilterInput中，添加listing筛选字段并标记为忽略自动查询转换：

public class UserFilterInput : FilterInputType<User>
{
    protected override void Configure(IFilterInputTypeDescriptor<User> descriptor)
    {
        descriptor.AddDefaults();
        // 添加自定义的listing筛选字段
        descriptor.Field("listing")
                  .Type<FilterInputType<ProjectDetailListing>>()
                  .Description("project listing")
                  .Ignore(); // 告诉系统不要自动生成该字段的查询转换
    }
}

2. 在Resolver中手动解析并应用筛选条件 #

在查询Users的Resolver中，先获取用户数据，加载对应的扩展属性，再手动应用筛选逻辑：

[ExtendObjectType(typeof(Query))]
public class UserQueries
{
    public async Task<IEnumerable<User>> GetUsers(
        [Service] IUserRepository userRepo,
        [Service] ProjectListingDataLoader dataLoader,
        [Filtering] UserFilterInput filter,
        CancellationToken cancellationToken)
    {
        // 1. 获取基础用户数据（可先应用User原生字段的筛选）
        var users = await userRepo.GetAllAsync(cancellationToken);
        
        // 2. 获取listing的筛选条件
        var listingFilter = filter.GetField<IFilterInputType>("listing") as FilterInputType<ProjectDetailListing>;
        
        if (listingFilter != null)
        {
            // 3. 批量加载所有用户的ProjectDetailListing数据
            var userIds = users.Select(u => u.Id).ToList(); // 假设User有Id字段用于关联
            var userListings = await dataLoader.LoadAsync(userIds, cancellationToken);
            
            // 4. 手动过滤符合条件的用户
            users = users.Where(u => 
            {
                if (userListings.TryGetValue(u.Id, out var listing))
                {
                    // 使用筛选器检查当前用户的listing是否符合条件
                    return listingFilter.Matches(listing);
                }
                return false; // 无数据时按需求返回true/false
            }).ToList();
        }
        
        // 5. 应用User原生字段的剩余筛选条件
        var filteredUsers = await filter.ApplyAsync(users.AsQueryable(), cancellationToken);
        
        return filteredUsers;
    }
}

3. 确保筛选约定正确注册 #

在服务配置中注册自定义筛选约定：

builder.Services.AddGraphQLServer()
    .AddQueryType()
    .AddFiltering<CustomFilteringConvention>()
    .AddType<UserExtensions>();

关键说明 #

• 使用.Ignore()禁用HotChocolate对扩展字段的自动查询转换，避免处理器缺失错误。
• 通过DataLoader批量加载扩展属性数据，保证性能。
• 手动调用筛选器的Matches方法检查数据是否符合条件，实现自定义筛选逻辑。

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