Apollo Server模块导入失败：TypeScript配置问题排查

开发者阿泽

2026-8-2

问题

在基于TypeScript的Node.js应用中导入Apollo Server后，出现大量类型报错，核心表现为Apollo无法找到graphql依赖中的相关类型（如GraphQLSchema、gql等），怀疑是TypeScript配置问题，当前tsconfig.json配置如下：

{
  "compilerOptions": {
    "target": "ES2022",
    "lib": [
      "ES2022"
    ],
    "module": "CommonJS",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "outDir": "dist",
    "sourceMap": true,
    "allowSyntheticDefaultImports": true,
    "types": ["node"],
    "baseUrl": "./src",
    "typeRoots": [
      "src/customTypings",
      "node_modules/@types"
    ],
  },
  "files": [
    "./node_modules/@types/mocha/index.d.ts",
    // "./node_modules/@types/node/index.d.ts"
  ],
  "include": [
    "src/**/*.ts",
    "src/**/*.json",
    "src/**/*.css",
    "src/**/*.map",
    "src/**/*.js",
    "src/**/*.svg",
    "src/public/**/*",
  ],
  "exclude": [
    "node_modules"
  ]
}

解决方案

删除files配置项：当前files数组手动指定了mocha的类型文件，这会覆盖TypeScript自动加载所有依赖类型的默认逻辑，导致graphql等依赖的类型无法被识别。直接移除整个files节点即可。
简化include配置：移除include中无关的非TS文件（如.css、.svg、.map等），只保留需要编译的文件类型，避免干扰类型检查：
```
"include": [
  "src/**/*.ts",
  "src/**/*.js",
  "src/**/*.json"
]
```
验证类型依赖：确认graphql包已正确安装（Apollo Server依赖的graphql自带类型定义，无需额外安装@types/graphql），如果之前误装了@types/graphql，建议卸载避免类型冲突。
可选：跳过库类型检查：如果仍有类型冲突报错，可在compilerOptions中添加"skipLibCheck": true，跳过第三方库的类型检查，但优先建议先解决类型引入的根本问题。