Angular遗留项目Docker更新Node镜像后CLI报错及版本兼容排查

先抓最直接的原因：工作目录不对 #

这个报错90%的情况是你在执行ng命令的时候，没站在Angular工作区的根目录。赶紧检查Dockerfile里的WORKDIR是不是指向了有angular.json（老版本是.angular-cli.json）的文件夹。举个正确的例子：

WORKDIR /app
# 先拷包文件装依赖
COPY package*.json ./
RUN npm install
# 再把整个项目代码拷进来（包括angular.json）
COPY . .
# 这时候再执行ng命令就没问题了
RUN ng build --prod

要是你COPY的时候漏了angular.json，或者WORKDIR设错了，CLI找不到工作区配置，肯定报这个错。

版本兼容别踩坑 #

遗留项目最容易栽在Node、npm、Angular CLI的版本匹配上：

• 先看你项目package.json里的@angular/cli版本，比如Angular 8对应Node 10/12，npm 6；Angular 10对应Node 12/14，npm 6/7，别瞎用最新的Node镜像。
• 如果Docker镜像自带的npm版本不对，直接手动装指定版本：

  RUN npm install -g npm@6.14.18
  

本地先测，排除项目本身问题 #

别光在Docker里瞎折腾，本地打开项目根目录，跑一遍和Docker里一样的ng命令：

• 本地也报错？那就是项目的问题：检查angular.json有没有、格式对不对；或者这个项目是不是压根没通过Angular CLI初始化（非CLI建的项目没有工作区配置，自然跑不了ng命令）。
• 本地正常？那就是Docker构建流程的问题：再核对一遍COPY命令有没有漏文件，WORKDIR是不是正确。

优先用本地CLI，别依赖全局的 #

遗留项目尽量用项目本地安装的Angular CLI，避免全局版本冲突：

# 用npx调用本地安装的CLI
RUN npx ng build --prod

或者直接在package.json的scripts里写好构建命令，然后执行：

RUN npm run build

（前提是你package.json里有类似"build": "ng build --prod"的脚本）

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