如何使用delegateToSchema在根层级直接暴露子schema字段？

完全可以通过delegateToSchema配合Schema Stitching实现，不需要为每个子字段单独编写显式解析逻辑，核心是让父Schema中Notification类型的非原生字段自动转发请求到子Schema，具体实现有两种常用方式：

方式1：基于graphql-tools Stitching 零代码配置（推荐） #

这是最省事的实现方式，不需要手写逐字段的resolver，只需要配置子Schema的合并规则即可：

• 第一步：在父Schema中扩展Notification类型，把需要从子服务获取的字段（title、body等）提前在SDL中声明，GraphQL校验阶段要求查询字段必须存在于Schema定义中，这是前置要求。后续新增子服务字段只需要在这里补SDL定义，不需要改解析逻辑。
• 第二步：在合并Schema时，给子服务配置Notification类型的合并规则，框架会自动处理字段转发、请求合并、去重逻辑，核心配置示例：

const { stitchSchemas } = require('@graphql-tools/stitch');

const stitchedSchema = stitchSchemas({
  subschemas: [
    // 引入父服务子Schema配置
    parentServiceSubschema,
    // 引入子服务子Schema配置，声明类型合并规则
    {
      schema: childServiceSubschema,
      merge: {
        Notification: {
          // 从父服务返回的根对象中取TWid，作为调用子服务接口的入参
          args: (parentRoot) => ({ twid: parentRoot.TWid }),
          // 子服务中查询单条通知的根字段名
          fieldName: 'notification',
          // 声明从父服务必须取到TWid字段，才能发起子服务请求
          selectionSet: '{ TWid }'
        }
      }
    }
  ],
  // 扩展父服务的Notification类型，补充子服务字段定义
  typeDefs: `
    extend type Notification {
      title: String
      body: String
    }
  `
});

配置完成后，直接在Notification根层级查询title、body字段时，框架会自动完成：从父服务拿到TWid、转发请求到子服务拉取对应字段、把返回结果合并到根层级响应，全程不需要单独给每个字段写解析逻辑。delegateToSchema能力已经被封装在stitching的内部逻辑中，会自动根据当前查询的字段拼接子服务请求的SelectionSet，不会拉取冗余字段，同一次查询中多个子字段只会触发一次子服务请求，没有N+1问题。

方式2：自定义默认解析器（适用于需要自定义转发逻辑的场景） #

如果不想用stitching的封装，也可以自己基于delegateToSchema写类型级的通用解析器，同样不需要逐字段配置：

• 给Notification类型配置代理级别的默认解析器，拦截所有字段访问：
  • 父服务原生字段（id、TWid）直接返回父服务响应中的对应值，不触发转发
  • 非原生字段第一次被访问时，统一调用delegateToSchema发起一次子服务请求，把当前查询涉及的所有子字段一次性拉取回来，缓存到当前根对象上，后续其他子字段直接从缓存取值，避免重复请求
    核心逻辑示例：

const { delegateToSchema } = require('@graphql-tools/delegate');

const resolvers = {
  Notification: new Proxy({}, {
    get: (_, fieldName) => {
      // 父服务原生字段直接走默认解析逻辑
      const parentNativeFields = ['id', 'TWid'];
      if (parentNativeFields.includes(fieldName)) return undefined;

      return async (root, args, context, info) => {
        // 未拉取过子服务数据时，一次性请求所有需要的子字段
        if (!root._cachedChildData) {
          root._cachedChildData = await delegateToSchema({
            schema: childServiceSchema,
            operation: 'query',
            fieldName: 'notification',
            args: { twid: root.TWid },
            context,
            info
          });
        }
        return root._cachedChildData[fieldName];
      }
    }
  })
};

关键注意点 #

• 必须提前在父Schema中声明所有子服务字段：GraphQL执行前会先做字段合法性校验，没有在SDL中定义的字段会直接报错，无法走到解析转发逻辑
• 不需要手动拼接子服务查询字段：delegateToSchema会自动读取当前查询AST中的selectionSet，把本次查询用到的所有子字段自动带到子服务请求中
• 天然避免重复请求：两种方式都可以保证同一次Notification节点查询中，不管查多少个子服务字段，只会发起一次子服务调用

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