Apollo 4 服务器间查询与变更（Mutations）实现难题求助

1. 无React依赖使用Apollo Client发起跨API请求 #

Apollo Client完全支持在Node.js服务器环境中使用，不需要依赖React。你之前遇到的依赖问题是因为默认安装的包包含了React相关适配，只需安装核心包和Node.js兼容的传输工具即可：

• 安装必要依赖：

npm install @apollo/client graphql cross-fetch

• 在静态服务器的解析器中初始化Apollo Client并发起请求：

const { ApolloClient, InMemoryCache, createHttpLink, gql } = require('@apollo/client');
const fetch = require('cross-fetch');

// 初始化客户端，ssrMode设为true适配服务器环境
const lambdaGraphQLClient = new ApolloClient({
  link: createHttpLink({
    uri: 'https://your-lambda-graphql-endpoint', // 替换为你的Lambda API地址
    fetch: fetch,
    // 按需添加认证、自定义头信息
    headers: {
      'Authorization': 'Bearer YOUR_AUTH_TOKEN'
    }
  }),
  cache: new InMemoryCache(),
  ssrMode: true
});

// 在变更解析器中转发请求
async function forwardCRMCreateMutation(parent, args) {
  const response = await lambdaGraphQLClient.mutate({
    mutation: gql`
      mutation CreateCRMRecord($input: CRMInput!) {
        createCRMRecord(input: $input) {
          id
          status
        }
      }
    `,
    variables: { input: args.input }
  });
  return response.data.createCRMRecord;
}

2. 轻量方案：直接用GraphQL工具+Fetch发起请求 #

如果不想引入Apollo Client，也可以用graphql核心包的工具构造请求，直接通过Fetch调用Lambda的GraphQL端点，这种方式更轻量化：

• 依赖（Node.js 18+可直接用内置fetch，无需额外安装）：

npm install graphql

• 示例代码：

const { parse, validate, specifiedRules } = require('graphql');
const { buildClientSchema } = require('graphql/utilities');

// 提前拉取并缓存Lambda的Schema（避免每次请求重复获取）
let cachedLambdaSchema = null;
async function getLambdaSchema() {
  if (cachedLambdaSchema) return cachedLambdaSchema;
  const res = await fetch('https://your-lambda-graphql-endpoint', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ query: '{ __schema { types { name fields { name type { name } } } } }' })
  });
  const schemaData = await res.json();
  cachedLambdaSchema = buildClientSchema(schemaData.data);
  return cachedLambdaSchema;
}

// 解析器中转发变更请求
async function forwardCRMCreateMutation(parent, args) {
  const schema = await getLambdaSchema();
  // 构造变更查询文档
  const mutationDoc = parse(`
    mutation CreateCRMRecord($input: CRMInput!) {
      createCRMRecord(input: $input) {
        id
        status
      }
    }
  `);
  // 验证查询合法性
  const validationErrors = validate(schema, mutationDoc, specifiedRules);
  if (validationErrors.length) {
    throw new Error(validationErrors.map(err => err.message).join(', '));
  }
  // 发送请求到Lambda
  const res = await fetch('https://your-lambda-graphql-endpoint', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      query: mutationDoc.loc.source.body,
      variables: { input: args.input }
    })
  });
  const result = await res.json();
  return result.data.createCRMRecord;
}

3. 最佳实践总结 #

• 优先选择Apollo Client方案：适合需要缓存、批量请求或复杂GraphQL操作的场景，配置简单，官方支持服务器端使用，且能统一前后端的GraphQL请求方式。
• 轻量方案适合简单场景：如果只是单纯转发请求，不想增加依赖体积，直接用Fetch+GraphQL核心工具的方式更合适。
• 两种方案均无需依赖React，你之前的问题是误装了包含React的完整包，只需安装核心依赖即可解决。

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