如何在Ruby微服务架构中聚合多个GraphQL查询根类型？

我明白你现在的困境——想要用GraphQL Ruby的类式API聚合多个模块的根查询和突变类型，又不想依赖即将在2.0版本被移除的旧.define语法。核心问题其实是GraphQL规范本身要求每个Schema只能有一个根Query类型和一个根Mutation类型，所以我们没法直接像你示例里那样加多个query或mutation声明，得换个思路：把各个模块的Query/Mutation字段整合到一个总控的根类型里，同时保持各模块的独立性。

下面是具体的实现方案，完全基于类式API，兼容GraphQL Ruby 2.0+：

1. 基础思路 #

我们会在main模块中创建总控的根Query和Mutation类，然后通过复用其他模块（Clients、Collaborators）已定义的字段和解析逻辑，把它们聚合到总控根类型中。这样既保留了各模块的代码隔离，又满足了Schema的单根类型要求。

2. 封装字段导入工具 #

为了避免重复代码，我们可以先封装一个辅助模块，用来批量导入其他类型的字段：

module OpenCompanyApi
  module Types
    # 辅助模块：批量导入其他GraphQL类型的字段到当前类型
    module FieldImporter
      def import_fields_from(other_type, prefix: nil)
        other_type.fields.each do |field_name, field_def|
          # 处理字段名冲突：可选添加模块前缀
          final_field_name = prefix ? "#{prefix}_#{field_name}" : field_name

          # 复制原字段的类型、可空性、描述
          field final_field_name, field_def.type, 
                null: field_def.null, 
                description: field_def.description do
            # 复制原字段的所有参数定义
            field_def.arguments.each do |arg_name, arg_def|
              argument arg_name, arg_def.type, 
                       required: arg_def.required, 
                       description: arg_def.description
            end
          end

          # 复用原类型的解析方法
          define_method(final_field_name) do |**args|
            other_type.new(object, context).public_send(field_name, **args)
          end
        end
      end
    end
  end
end

3. 创建总控根Query和Mutation类 #

接下来在main模块中创建总控的根类型，使用上面的工具导入其他模块的字段：

module OpenCompanyApi
  module Types
    class Query < GraphQL::Schema::Object
      extend FieldImporter

      # 导入Clients模块的所有查询字段，可选加前缀避免冲突
      import_fields_from Clients::Graphql::Types::Query, prefix: :clients
      # 导入Collaborators模块的所有查询字段
      import_fields_from Collaborators::Graphql::Types::Query, prefix: :collaborators
    end

    class Mutation < GraphQL::Schema::Object
      extend FieldImporter

      # 同样导入两个模块的突变字段
      import_fields_from Clients::Graphql::Types::Mutation, prefix: :clients
      import_fields_from Collaborators::Graphql::Types::Mutation, prefix: :collaborators
    end
  end

  # 最终的Schema配置
  class Schema < GraphQL::Schema
    query Types::Query
    mutation Types::Mutation
  end
end

4. 关键细节说明 #

• 字段冲突处理：如果两个模块有同名的字段（比如都叫list），添加前缀（如clients_list、collaborators_list）可以避免覆盖问题。如果确定字段名不会冲突，可以去掉prefix参数。
• 解析逻辑复用：通过实例化原模块的Query/Mutation对象并调用对应的方法，我们完全复用了各模块已写好的解析逻辑，不需要重复编写业务代码。
• 类式API兼容性：整个方案完全使用GraphQL Ruby的类式API（GraphQL::Schema::Object、field、argument等），没有用到旧的.define语法，完全适配2.0+版本。

5. 示例验证 #

假设Clients模块的Query有一个client字段，Collaborators模块的Query有一个collaborator字段，那么现在你的Schema就可以接收这样的查询：

query {
  clients_client(id: "1") {
    id
    name
  }
  collaborators_collaborator(id: "2") {
    id
    email
  }
}

这样就实现了你想要的多模块字段聚合的效果，同时符合GraphQL的规范和GraphQL Ruby的最新API要求。

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