Docker构建Node+TypeScript项目出现Jest相关TS错误如何解决？

你本地构建正常、Docker构建报错的核心原因有两个：

• Docker镜像使用的Node.js版本与本地开发版本不匹配，且安装依赖时未复用锁文件，导致依赖实际安装版本与本地不一致
• jest相关依赖版本不兼容，且tsconfig配置存在疏漏

1. 对齐依赖版本，解决首个jest.Mock不存在报错 #

你当前使用的jest-extended@0.11.5最高仅支持@types/jest@26，与你安装的@types/jest@27版本不兼容，两种修复方案二选一即可：

• 方案一：升级jest-extended到兼容jest 27的版本，执行npm install jest-extended@^1.0.0 --save-dev
• 方案二：降级@types/jest到26.x版本，执行npm install @types/jest@^26.0.0 --save-dev

2. 修正Dockerfile，消除环境差异 #

修改Dockerfile，先复制锁文件保证依赖版本和本地完全一致，同时替换Node.js基础镜像版本和你的本地开发版本对齐（你package中@types/node为16，建议换成node:16镜像）：

# 替换为和本地开发环境完全一致的Node.js版本
FROM node:16
# 先复制package文件和锁文件，利用Docker缓存同时保证依赖版本一致
COPY package.json package-lock.json /opt/service/
WORKDIR /opt/service/
RUN npm ci
COPY . .
RUN npm run build
...

用npm ci代替npm install可以严格按照lock文件安装依赖，完全对齐本地的依赖版本，不会出现本地和容器内依赖版本不一致的问题。

3. 修正tsconfig配置，解决测试文件报错 #

测试文件不需要参与生产构建，直接把测试文件加到排除列表即可，修改tsconfig.json的exclude字段：

"exclude": ["node_modules", "lib", "jest.*.ts", "jest.*.js", "**/generated/*", "**/*.test.ts", "**/*.spec.ts"]

如果你需要在本地开发时保留对测试文件的类型检查，可以单独给测试场景建一个tsconfig.test.json，或者在原tsconfig的compilerOptions中补充jest类型声明：

"compilerOptions": {
  // 其他原有配置全部保留
  "types": ["jest", "jest-extended"]
}

不需要额外开启skipLibCheck，完成上述操作后所有报错都会被彻底解决。

内容的提问来源于stack exchange，提问作者Finnur Eiríksson