Docker构建Ionic/Angular应用时出现Cannot find module - ng错误

错误根源 #

1. Node版本不兼容：Docker中使用的node:latest镜像会自动拉取最新版本（当前为v20.0.0），但你使用的Angular 15.2.7官方仅支持Node 14.20+/16.13+/18.10+，Node 20不在兼容列表内，版本冲突导致构建失败。
2. 本地依赖缺失：执行pnpm run build时，pnpm默认优先查找项目本地的@angular/cli模块，但你的项目依赖中未包含该包，全局安装的版本无法被pnpm的本地执行环境识别。

可行解决方案 #

方案1：固定Node版本（推荐） #

修改Dockerfile的基础镜像为你本地使用的Node 16.18.0，避免latest镜像自动更新带来的版本波动：

FROM node:16.18.0 as build
# 后续构建步骤保持不变

方案2：添加本地@angular/cli依赖 #

在项目根目录执行命令，将@angular/cli添加为开发依赖：

pnpm add -D @angular/cli@15.2.7

提交更新后的package.json和pnpm-lock.yaml到代码库，重新执行Docker构建即可。

方案3：直接调用全局Angular CLI #

调整Dockerfile中的构建命令，直接使用全局安装的ng命令替代pnpm run build：

# 替换原有的RUN pnpm run build
RUN ng build

你的Dockerfile已配置PNPM_HOME到环境变量，全局ng命令可正常被调用。

补充说明 #

昨天能正常构建是因为当时node:latest对应兼容Angular 15的Node版本（如Node 18），而本次构建时--pull参数拉取了最新的Node 20镜像，触发了版本不兼容问题。使用固定版本的基础镜像是Docker构建的最佳实践，可避免此类突发问题。

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