Angular项目Docker容器启动报错：找不到@angular-devkit/build-angular:dev-server包

原因排查与修复方案 #

1. 修正Dockerfile的依赖处理逻辑 #

确保构建阶段完整安装所有依赖（包括开发依赖），并将安装好的node_modules正确复制到运行环境。以下是适配Node 18的多阶段构建示例：

# 构建阶段
FROM node:18-alpine AS builder
WORKDIR /app/client
COPY package*.json ./
RUN npm install  # 不要加--production，否则会跳过@angular-devkit这类开发依赖
COPY . .
RUN npm run build --prod

# 开发环境运行阶段（用于dev-server）
FROM node:18-alpine
WORKDIR /app/client
COPY --from=builder /app/client/package*.json ./
COPY --from=builder /app/client/node_modules ./node_modules
COPY --from=builder /app/client ./
CMD ["npm", "start"]

2. 调整docker-compose的挂载配置 #

如果docker-compose中挂载了本地目录，必须避免覆盖容器内的node_modules，否则本地未安装依赖的目录会替换容器内的依赖包。修改volumes部分：

services:
  angular-app:
    build: ./client
    ports:
      - "4200:4200"
    volumes:
      - ./client:/app/client
      - /app/client/node_modules  # 匿名挂载保留容器内的node_modules

3. 验证Angular包版本兼容性 #

检查package.json中@angular/cli与@angular-devkit/build-angular的版本是否匹配，版本不兼容会导致构建器无法识别。可在本地执行npm install @angular-devkit/build-angular@latest更新依赖后，重新构建镜像。

4. 清理Docker缓存与旧镜像 #

谷歌云机器上的Docker缓存可能导致依赖未正确更新，执行以下命令重置后重新构建：

sudo docker-compose down
sudo docker system prune -af
sudo docker-compose build --no-cache
sudo docker-compose up

5. 检查容器内依赖状态 #

临时修改Dockerfile的CMD命令，进入容器查看依赖是否存在：

CMD ["sh", "-c", "ls node_modules/@angular-devkit/build-angular && npm start"]

如果ls输出为空，说明依赖未正确安装，需回到步骤1检查npm install的执行逻辑。

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