Docker构建Angular前端镜像时出现Segmentation fault错误求助

问题描述 #

构建Angular前端Docker镜像时，[builder 7/7]阶段执行RUN npm run ng build --aot --base-href=/ --configuration=dev命令抛出Segmentation fault错误，返回退出码139。

执行的构建命令：

docker build -t {{url}}:{{tag}} --platform linux/amd64 --build-arg conf=dev --build-arg path=frontend .

已确认信息 #

• 本地直接执行ng build --aot --base-href=/ --configuration=dev无异常
• 部分团队成员可正常构建，但升级macOS到14.4.1后出现相同错误
• 本地环境：Angular 16.2.12、Node 18.18.2、npm 10.5.1、macOS Sonoma 14.4.1、Docker 25.0.3
• Docker Desktop配置：CPU限制8核、内存14GB
• 已尝试操作：重装Docker/Angular、升级软件版本、检查模块兼容性、调整Docker资源、验证本地命令、确认Dockerfile无问题（其他成员可正常使用）

排查与解决提示 #

1. 调整平台兼容参数
   若本地为ARM架构Mac（M系列芯片），尝试去掉--platform linux/amd64参数，或替换为--platform linux/arm64匹配本地架构。跨架构模拟可能触发内存或指令集相关的段错误。

2. 更换Node基础镜像类型
   检查Dockerfile中的Node镜像，若使用node:18-alpine，换成node:18-bullseye-slim或node:18-bookworm。Alpine镜像的musl libc在部分场景下与Angular AOT编译存在兼容性问题，易引发段错误。

3. 禁用并行编译
   在构建命令中追加--no-parallel参数，即：

   RUN npm run ng build --aot --base-href=/ --configuration=dev --no-parallel
   

   或在angular.json的architect.build.options中添加"parallel": false。Docker构建环境的资源调度逻辑与本地不同，并行编译可能触发内存访问异常。

4. 清理Docker构建缓存
   执行以下命令清理所有构建缓存，避免旧缓存产物引发的异常：

   docker builder prune -a
   

5. 降级Docker版本
   尝试将Docker降级至24.x稳定版本（如24.0.7），Docker 25.x在macOS Sonoma 14.4.1上可能存在架构兼容bug，导致构建阶段出现段错误。

6. 同步依赖版本
   对比能正常构建的团队成员的锁文件（package-lock.json/pnpm-lock.yaml），同步依赖版本。部分依赖的特定版本在跨架构构建场景下存在兼容性问题。

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