.NET Core中GraphQL多资源查询的拆分方案咨询

你遇到的问题其实是GraphQL规范和.NET Core依赖注入结合时的典型场景——GraphQL本身要求每个服务对应单一Schema，而你尝试注册多个ISchema实例会被DI容器覆盖，这不是实现问题，而是设计思路的问题。

不用把所有查询都塞进一个类里，我们可以通过模块化拆分Query字段+单一根Schema的方式来解决，既保持代码整洁，又符合GraphQL的规范。下面是具体的实现方案：

核心思路 #

把每个业务模块的Query（比如User、Task）做成独立的ObjectGraphType子类，然后创建一个根Query类，负责将所有模块的Query字段合并到一起，最后只注册一个根Schema指向这个根Query。

具体实现步骤 #

1. 保留独立的模块Query类 #

你的UserQuery和TaskQuery可以保持原有的结构，每个类只负责自己业务领域的查询字段：

public sealed class UserQuery : ObjectGraphType
{
    private List<User> users = new List<User>();

    public UserQuery()
    {
        Field<ListGraphType<UserType>>(
            "users",
            "Returns a collection of users.",
            resolve: context => users);
    }
}

public sealed class TaskQuery : ObjectGraphType
{
    private List<Task> tasks = new List<Task>();

    public TaskQuery()
    {
        Field<ListGraphType<TaskType>>(
            "tasks",
            "Returns a collection of tasks.",
            resolve: context => tasks);
    }
}

2. 创建根Query类合并所有模块字段 #

创建一个RootQuery，通过构造函数注入各个模块的Query实例，然后将它们的字段全部合并到根Query中：

public sealed class RootQuery : ObjectGraphType
{
    public RootQuery(UserQuery userQuery, TaskQuery taskQuery)
    {
        // 合并UserQuery的所有字段
        foreach (var field in userQuery.Fields)
        {
            AddField(field);
        }

        // 合并TaskQuery的所有字段
        foreach (var field in taskQuery.Fields)
        {
            AddField(field);
        }
    }
}

3. 创建单一根Schema #

只需要一个Schema指向根Query即可：

public sealed class RootSchema : GraphQL.Types.Schema
{
    public RootSchema(RootQuery rootQuery)
    {
        Query = rootQuery;
    }
}

4. 注册服务 #

现在只需要注册根Schema，同时把各个模块的Query注册为依赖：

serviceCollection
    .AddSingleton<UserQuery>()
    .AddSingleton<TaskQuery>()
    .AddSingleton<RootQuery>()
    .AddSingleton<ISchema, RootSchema>();

进阶优化：支持大规模模块扩展 #

如果你的项目有100+查询字段，手动在根Query里注入每个模块会很麻烦，我们可以通过标记接口+批量注入的方式优化：

1. 定义一个标记接口，用于标识所有查询模块：

public interface IQueryModule : IObjectGraphType { }

2. 修改模块Query类实现这个接口：

public sealed class UserQuery : ObjectGraphType, IQueryModule { /* 原有代码 */ }
public sealed class TaskQuery : ObjectGraphType, IQueryModule { /* 原有代码 */ }

3. 修改根Query，批量注入所有查询模块：

public sealed class RootQuery : ObjectGraphType
{
    public RootQuery(IEnumerable<IQueryModule> queryModules)
    {
        foreach (var module in queryModules)
        {
            foreach (var field in module.Fields)
            {
                AddField(field);
            }
        }
    }
}

4. 注册服务时，只需注册所有IQueryModule实现：

serviceCollection
    .AddSingleton<IQueryModule, UserQuery>()
    .AddSingleton<IQueryModule, TaskQuery>()
    // 新增模块时只需要加这一行即可
    // .AddSingleton<IQueryModule, OrderQuery>()
    .AddSingleton<RootQuery>()
    .AddSingleton<ISchema, RootSchema>();

为什么这个方案更好？ #

• 遵循GraphQL单一Schema的规范，客户端可以通过一个端点统一查询所有业务数据
• 每个查询模块保持独立，符合单一职责原则，代码更易维护
• 扩展成本极低，新增业务模块时只需实现IQueryModule并注册，无需修改根Query或Schema

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