构建遗留Angular应用Docker镜像时遇Exit status 1错误求助

核心排查方向 #

• 依赖版本一致性校验
  STAGE环境正常运行，优先确认Docker构建环境与STAGE的依赖版本完全对齐：
  • 对比package.json中dependencies、devDependencies的版本约束，确保Docker构建时未拉取到存在兼容问题的新版本依赖
  • 必须将package-lock.json（或yarn.lock）同步复制到镜像构建上下文，避免依赖版本漂移
• 构建环境版本匹配
  • 核对Dockerfile中Node.js基础镜像版本，必须与STAGE环境使用的Node版本完全一致（例如STAGE用Node 14.17.0，镜像不能用Node 18.x）
  • 确保Docker内的构建命令与STAGE完全相同，比如STAGE用ng build --prod，镜像内命令不能省略参数或使用错误的构建模式
• 容器权限问题
  Docker默认用户可能缺乏文件读写权限，导致构建过程无法生成产物：
  • 在Dockerfile中添加权限调整指令，比如RUN chmod -R 755 /app，或切换到非root用户后配置对应权限
• 构建日志细节定位
  重点查看Exit 1报错前的具体日志：
  • 是否存在依赖安装失败（如包下载超时、网络受限）
  • 是否有Angular编译错误（如代码语法问题、模块引用缺失）
  • 是否遗漏了STAGE环境存在的静态资源文件（未复制到镜像构建上下文）

快速验证步骤 #

1. 在本地使用与Docker镜像一致的Node版本，执行npm install和构建命令，复现错误确认根源
2. 将STAGE环境的node_modules目录打包至构建上下文，在Dockerfile中跳过依赖安装直接构建，验证是否为依赖安装环节问题
3. 逐步简化Dockerfile：先完成基础镜像拉取、代码复制、依赖安装，再添加构建命令，定位具体出错步骤

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