Apollo Server v2迁移v4遇重复GraphQL模块问题及配置咨询

一、重复GraphQL模块编译错误排查 #

你遇到的"无法使用来自其他模块的GraphQLObjectType 'Query'"错误，核心是项目中存在多版本graphql实例。即便配置了resolutions，仍可能因以下原因失效：

排查与修复步骤： #

• 检查依赖树：执行npm ls graphql（npm）或yarn list graphql（yarn），确认是否有依赖包强制引入其他版本的graphql。如果有，用overrides（npm 8+推荐，替代resolutions）统一版本：

  "overrides": {
    "graphql": "16.8.0"
  }
  

• 清理缓存重装：删除node_modules、package-lock.json（或yarn.lock），执行npm cache clean --force后重新npm install。
• 调整Serverless插件配置：serverless-plugin-browserify可能打包重复模块，需在插件配置中指定graphql的统一路径：

  plugins:
    - serverless-plugin-browserify
  custom:
    browserify:
      alias:
        graphql: './node_modules/graphql'
  

• 确认resolutions生效：npm默认不支持resolutions，建议用yarn或添加npm install --force强制生效，优先使用overrides更稳妥。

二、当前中间件配置合理性分析 #

你的代码存在几个关键问题：

1. 重复创建ApolloServer实例：将初始化逻辑放在express中间件内，每次请求都会新建实例，严重影响性能，需移到中间件外全局仅执行一次。
2. 上下文配置冲突：apolloConfig与expressMiddleware中的context重复，需统一到一处（推荐在expressMiddleware中配置）。
3. 冗余导入冲突：同时导入graphql-scalars和graphql-type-json的GraphQLJSON，造成类型冲突，需移除其中一个（推荐保留graphql-scalars的实现）。
4. Mock配置滥用：addMocksToSchema默认开启会覆盖真实Resolver，仅应在开发环境启用。

优化后的核心代码示例：

import { ApolloServer } from '@apollo/server';
import { expressMiddleware } from '@apollo/server/express4';
import { ApolloServerPluginDrainHttpServer } from '@apollo/server/plugin/drainHttpServer';
import { makeExecutableSchema, addMocksToSchema } from '@graphql-tools/schema';
import express from 'express';
import http from 'http';
import cors from 'cors';
import { json } from 'body-parser';
import initializeTypeDefs from '../helpers/initializeTypeDefs';
import initializeResolvers from '../helpers/initializeResolvers';
import { GraphQLJSON, GraphQLDate, GraphQLDateTime, GraphQLLocalDate } from 'graphql-scalars';

const app = express();
const httpServer = http.createServer(app);

// 全局初始化ApolloServer，仅执行一次
const startServer = async () => {
  const typeDefs = await initializeTypeDefs();
  let resolvers = initializeResolvers();
  
  // 合并scalars解析器
  resolvers = {
    ...resolvers,
    JSON: GraphQLJSON,
    Date: GraphQLDate,
    DateTime: GraphQLDateTime,
    LocalDate: GraphQLLocalDate
  };

  let schema = makeExecutableSchema({ typeDefs, resolvers });
  
  // 仅开发环境启用Mock
  if (process.env.stage === 'dev') {
    schema = addMocksToSchema({ schema });
  }

  const apolloServer = new ApolloServer({
    schema,
    plugins: [ApolloServerPluginDrainHttpServer({ httpServer })],
    introspection: process.env.stage !== 'production' // 生产环境禁用 introspection
  });

  await apolloServer.start();

  // 挂载GraphQL路由
  app.use(
    '/graphql',
    cors<cors.CorsRequest>(),
    json(),
    expressMiddleware(apolloServer, {
      context: async ({ req, res }) => ({
        user: res.locals?.user ?? null,
        token: req.headers.token
      })
    })
  );

  // 请求结束后销毁Knex连接
  app.use((_, res, next) => {
    res.on('finish', async () => {
      await Model.knex().destroy();
    });
    next();
  });

  console.log('🚀 Server ready at http://localhost:3000/graphql');
};

startServer();
app.use('/v1', v1Api);

三、Apollo Server v2 到 v4 简易迁移流程 #

1. 依赖升级：

   # 卸载旧依赖
   npm uninstall apollo-server apollo-server-express
   # 安装v4核心依赖
   npm install @apollo/server express graphql cors body-parser
   

2. 初始化逻辑调整：
   • 从@apollo/server导入ApolloServer，用@apollo/server/express4的expressMiddleware替代原applyMiddleware。
   • 提前用@graphql-tools/schema的makeExecutableSchema构建可执行Schema，再传入ApolloServer。
3. 插件配置：必须添加ApolloServerPluginDrainHttpServer插件，确保服务优雅关闭。
4. 上下文配置：v4中上下文通过expressMiddleware的context选项配置，参数包含req、res等请求对象。
5. 移除过时API：
   • 移除graphiql选项，v4默认启用Apollo Sandbox（生产环境需关闭introspection）。
   • 原formatError等配置移至ApolloServer构造函数的plugins或Schema中处理。

四、GraphQL Scalars解析器替代连接方式 #

1. 统一使用graphql-scalars：移除graphql-type-json依赖，所有自定义标量均使用graphql-scalars的实现。
2. 合并类型定义与解析器：

   // 导入scalars的类型定义和解析器
   import { typeDefs as scalarsTypeDefs, resolvers as scalarsResolvers } from 'graphql-scalars';
   
   // 合并到总typeDefs和resolvers
   const typeDefs = [scalarsTypeDefs, ...yourTypeDefs];
   const resolvers = { ...scalarsResolvers, ...yourResolvers };
   

3. 按需引入：如果不需要所有scalars，可单独导入所需类型：

   import { GraphQLJSON, GraphQLDate } from 'graphql-scalars';
   import { typeDefs as jsonTypeDefs } from 'graphql-scalars/dist/typeDefs/JSON';
   import { typeDefs as dateTypeDefs } from 'graphql-scalars/dist/typeDefs/Date';
   
   const typeDefs = [jsonTypeDefs, dateTypeDefs, ...yourTypeDefs];
   const resolvers = { JSON: GraphQLJSON, Date: GraphQLDate, ...yourResolvers };
   

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