Angular12生产环境Docker构建时npm run build出现esbuild报错

你遇到的esbuild报错核心是跨架构可执行文件不兼容，具体触发逻辑如下：

• 错误日志中的MZ是Windows PE格式可执行文件的固定头部标识，说明执行的esbuild.exe是Windows平台编译的版本，无法在Linux内核的Docker容器中运行，因此抛出文件无法识别、语法错误的提示。
• Angular 12默认仅在生产环境构建时启用esbuild作为打包/压缩工具，开发环境构建不会触发esbuild调用，因此只有生产构建流程会触发该报错。
• 你当前的Dockerfile执行逻辑存在漏洞：先在容器内执行npm install安装了适配Linux架构的依赖，随后执行COPY . /app时，将本地Windows环境生成的node_modules目录直接覆盖了容器内的对应目录，最终调用到了Windows版本的esbuild可执行文件。

• 新增.dockerignore文件：在项目根目录创建该文件，添加以下内容，避免复制本地无关文件覆盖容器内的依赖：

node_modules
.git
dist
.angular
.env
.DS_Store

• 修正Dockerfile配置：EXPOSE指令仅用于声明容器运行时监听的端口，不支持端口映射配置（端口映射需要在docker run时通过-p 4200:80参数指定），将原EXPOSE 4200:80修改为EXPOSE 80即可。
• 可选兼容方案：如果修改后仍存在esbuild架构不匹配问题，可以在npm install步骤后强制安装Linux版本的esbuild：

RUN npm install
# 强制安装对应Linux x64架构的esbuild
RUN npm install esbuild@$(node -p "require('esbuild/package.json').version") --force --platform=linux --arch=x64

修正后的完整Dockerfile参考：

FROM node:16.8.0 as build-step
RUN mkdir -p /app
WORKDIR /app
COPY package.json /app
RUN npm install
# 可选强制安装Linux版esbuild
# RUN npm install esbuild@$(node -p "require('esbuild/package.json').version") --force --platform=linux --arch=x64
COPY . /app
RUN npm run build

FROM nginx:1.20.1
COPY --from=build-step /app/dist/my-app /usr/share/nginx/html
EXPOSE 80

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