Angular 6.0.3在Docker中运行失败：找不到@angular-devkit/build-angular模块

看起来你遇到的问题是Docker容器内找不到@angular-devkit/build-angular模块，虽然本地环境一切正常。这个问题通常和Docker构建过程中依赖安装的顺序、版本兼容性，或者本地文件的干扰有关。

先看看你遇到的错误核心：

Could not find module "@angular-devkit/build-angular" from "/usr/src/app".

问题分析 #

你的Dockerfile存在几个可能导致问题的点：

1. 先复制整个项目再安装依赖：你直接把quickstart目录复制到容器里，如果本地的node_modules也被复制进去，会干扰容器内的依赖安装过程。
2. 全局Angular CLI版本不匹配：你全局安装了最新版的@angular/cli，但Angular 6需要对应版本的CLI（6.x系列），版本不兼容会导致构建模块找不到。
3. 端口配置不一致：Dockerfile里暴露的是4200，但启动命令用的是3000，虽然这不是直接导致模块找不到的原因，但会导致后续端口映射问题。

解决方案 #

1. 添加.dockerignore文件

首先在项目根目录创建.dockerignore，避免本地的node_modules和无关文件被复制到容器中：

node_modules/
npm-debug.log
.DS_Store

2. 修改Dockerfile优化构建流程

调整Dockerfile的步骤，利用Docker缓存并确保依赖安装正确：

# 基于官方Node 8.10.0镜像构建
FROM node:8.10.0

# 设置工作目录
WORKDIR /usr/src/app

# 先复制依赖配置文件，优先利用Docker缓存
COPY ./quickstart/package*.json ./

# 清理旧依赖并安装项目依赖
RUN rm -rf node_modules && npm install

# 安装与Angular 6匹配的CLI版本（6.2.9是Angular 6的稳定版本）
RUN npm install -g @angular/cli@6.2.9

# 复制项目的其余文件
COPY ./quickstart/ .

# 暴露启动命令中使用的端口3000
EXPOSE 3000

# 启动应用
CMD ["npm", "start"]

3. 验证package.json中的依赖

确保你的package.json中已经包含@angular-devkit/build-angular依赖（Angular 6中它是必需的），可以检查dependencies或devDependencies中是否有这一项：

"devDependencies": {
  "@angular-devkit/build-angular": "~0.6.8",
  // 其他依赖...
}

为什么这样修改？ #

• 先复制package文件：Docker会缓存依赖安装的步骤，只要package.json和package-lock.json没有变化，下次构建就会跳过重新安装依赖，大大加快构建速度。
• 匹配CLI版本：全局CLI版本和项目依赖的CLI版本保持一致，避免版本不兼容导致的模块缺失问题。
• 排除本地node_modules：通过.dockerignore避免本地依赖干扰容器内的依赖环境，确保容器内安装的依赖是干净的。

按照这个步骤重新构建并启动容器，应该就能解决找不到@angular-devkit/build-angular的问题了。

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