Hasura GraphQL端点部署于Apollo联邦网关后的可行性咨询

完全可行！我身边好几个团队都是这么做的——把Hasura作为普通子图接入Apollo联邦网关，而不是让它担任联邦核心节点，完全匹配你的思路。Hasura的GraphQL端点是标准的GraphQL服务，完全支持被Apollo Server包装成联邦子图后接入网关。

为什么这个方案能行？ #

Hasura本身提供标准的Schema introspection和查询能力，Apollo联邦的生态（@apollo/subgraph、@graphql-tools/wrap等工具）可以轻松把Hasura的Schema包装成符合联邦规范的子图，再注册到Apollo网关。不需要Hasura做任何核心节点的配置，完全按你想的“搭载远程Schema的Apollo Server连接Hasura，再置于网关之后”的模式运行。

搭建Express Apollo Server连接Hasura的关键步骤（帮你排查失败点） #

如果你之前尝试搭建失败，大概率是联邦配置或远程Schema拼接的细节没处理对，给你整理核心步骤：

• 版本匹配：确保使用@apollo/server v4+搭配@apollo/subgraph、@graphql-tools/wrap等依赖，版本不兼容是常见坑；
• 远程获取并包装Hasura Schema：用@graphql-tools/wrap工具拉取Hasura的Schema，再包装成可执行的子图，示例代码如下：

const { ApolloServer } = require('@apollo/server');
const { startStandaloneServer } = require('@apollo/server/standalone');
const { wrapSchema, introspectSchema } = require('@graphql-tools/wrap');
const { print } = require('graphql');
const fetch = require('cross-fetch');

async function createHasuraSubgraph() {
  // 1. 远程 introspect Hasura 的 Schema
  const hasuraExecutor = async (query) => {
    const res = await fetch('YOUR_HASURA_GRAPHQL_ENDPOINT', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-hasura-admin-secret': 'YOUR_HASURA_ADMIN_SECRET' // Hasura启用认证时必填
      },
      body: JSON.stringify({ query })
    });
    return res.json();
  };
  const hasuraSchema = await introspectSchema(hasuraExecutor);

  // 2. 包装成可执行的远程Schema
  const wrappedSchema = wrapSchema({
    schema: hasuraSchema,
    executor: async ({ document, variables }) => {
      const query = print(document);
      return hasuraExecutor(query, variables);
    }
  });

  // 3. 标记为联邦子图（*关键！没有这一步网关无法识别*）
  const federatedSchema = buildSubgraphSchema([{ schema: wrappedSchema }]);

  // 启动Apollo Server子图
  const server = new ApolloServer({ schema: federatedSchema });
  const { url } = await startStandaloneServer(server, { listen: { port: 4001 } });
  console.log(`Hasura子图已启动：${url}`);
}

createHasuraSubgraph();

• 联邦类型关联（可选但实用）：如果需要让Hasura的类型和其他子图的类型关联（比如用户ID跨子图关联），可以在Apollo Server里扩展Hasura的类型，添加联邦指令，示例：

// 扩展Hasura的User类型，添加联邦@key标识
const extendedTypeDefs = `
  extend type User @key(fields: "id") {
    id: ID! @external
  }
`;

// 合并扩展类型和包装后的Schema
const mergedSchema = mergeSchemas({
  schemas: [wrappedSchema, extendedTypeDefs]
});

// 再用mergedSchema构建联邦子图
const federatedSchema = buildSubgraphSchema([{ schema: mergedSchema }]);

额外注意事项 #

• 权限传递：不要在子图里硬编码Hasura的admin secret，建议通过网关的请求上下文传递用户身份，再转发给Hasura（比如把网关中的用户token转换成Hasura的x-hasura-user-id等请求头）；
• 性能优化：远程Schema拼接会多一层转发，建议在Apollo Server和Hasura之间添加查询缓存，或者启用Hasura自带的查询缓存；
• 版本兼容性：Hasura v2.0+版本完全支持这种模式，更早版本可能在Schema introspection上有小问题，但大部分场景也能正常运行。

内容的提问来源于stack exchange，提问作者T.Davidson