迁移NestJS至Apollo v4时，本地着陆页插件与GraphQLModule类型不兼容

问题根源 #

你的依赖列表中同时存在 Apollo v4 的 @apollo/server 和 v3 的 apollo-server-core/apollo-server-express，两个版本的插件类型定义完全不兼容，导致 TypeScript 抛出参数类型不匹配的错误。

解决方案步骤 #

1. 移除旧版 Apollo v3 依赖
   直接从 package.json 中删除 apollo-server-core 和 apollo-server-express，或执行命令：

   # npm
   npm uninstall apollo-server-core apollo-server-express
   
   # yarn
   yarn remove apollo-server-core apollo-server-express
   

2. 清理缓存并重新安装依赖
   彻底清除旧依赖残留，确保所有类型声明一致：

   # npm 用户
   rm -rf node_modules package-lock.json
   npm install
   
   # yarn 用户
   rm -rf node_modules yarn.lock
   yarn install
   

3. 验证配置（无需修改）
   你的 GraphQLModule 配置已经符合 Apollo v4 + NestJS 的要求，保持现有代码即可：

   import { ApolloDriver, ApolloDriverConfig } from '@nestjs/apollo';
   import { Module } from '@nestjs/common';
   import { GraphQLModule } from '@nestjs/graphql';
   import { join } from 'path';
   import { ApolloServerPluginLandingPageLocalDefault } from '@apollo/server/plugin/landingPage/default';
   import { DenunciaDetallesModule } from './registry/denuncia-detalles/denuncia-detalles.module';
   
   @Module({
     imports: [
       GraphQLModule.forRoot<ApolloDriverConfig>({
         autoSchemaFile: join(process.cwd(), 'src/schema.gql'),
         sortSchema: true,
         driver: ApolloDriver,
         playground: false,
         plugins: [ApolloServerPluginLandingPageLocalDefault()],
       }),
       DenunciaDetallesModule,
     ],
   })
   export class AppModule {}
   

补充说明 #

Apollo v4 完全重构了包体系，用 @apollo/server 统一替代了 v3 时代的 apollo-server-core、apollo-server-express 等拆分包，同时插件的上下文类型定义也做了大幅调整。保留旧版依赖会导致 TypeScript 加载冲突的类型声明，进而出现 GraphQLServiceContext 与 GraphQLServerContext 不兼容的错误。

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