Windows构建ReactJS arm64 Docker镜像在AWS t4g实例运行报exec格式错误

• 核心原因是Dockerfile构建逻辑缺陷+缺少文件过滤规则，导致镜像被本地amd64架构文件污染。你先在arm64模拟环境中执行npm install安装了对应架构的依赖，随后执行COPY .. ./时，会把本地Windows（x86/amd64架构）工作目录下的所有文件直接覆盖容器内文件：如果本地存在node_modules目录，其中包含的平台绑定原生模块（比如esbuild、swc、node-sass等带预编译二进制的依赖）会直接替换容器内安装的arm64版本；如果本地脚本是Windows默认的CRLF换行格式，也会导致shell脚本执行时报格式错误。你构建的Python镜像没有该问题，是因为Python项目构建时通常不会把本地虚拟环境目录拷贝进镜像，不存在跨架构文件覆盖。
• 构建命令参数缺失：跨架构构建时未加--load参数，在Windows+WSL2的Docker Desktop环境下，buildx默认会把构建结果存在专属缓存中，不会正确导入本地镜像存储，会出现镜像元数据标注为arm64、但实际镜像层存在架构混用的情况。
• Dockerfile存在不规范配置：WORKDIR .使用相对路径会导致容器内工作目录不确定，容易触发路径解析异常；构建完静态产物后依然用npm start启动开发服务器，会加载大量开发态原生依赖，进一步放大架构不匹配的问题。
• 补充验证：你在EC2 arm64实例上用相同Dockerfile本地构建能正常运行，就是因为原生arm64环境构建不存在跨架构模拟问题，且EC2上拉取的代码没有本地Windows的amd64版本node_modules污染。

按以下步骤调整即可解决问题：

1. 首先在项目根目录创建.dockerignore文件，过滤不需要进入镜像的本地文件，从根源避免污染：

node_modules
build
.git
*.md
.env*
.DS_Store
npm-debug.log*
docker-compose*
Dockerfile
.dockerignore

2. 替换原有Dockerfile为多阶段构建配置，既避免依赖污染，也能大幅减小镜像体积：

# 构建阶段：用BUILDPLATFORM匹配构建机架构加速依赖安装
FROM --platform=$BUILDPLATFORM node:18-alpine AS builder
WORKDIR /app
# 先拷贝依赖描述文件，利用docker缓存
COPY package.json package-lock.json ./
# 用npm ci安装锁定版本依赖，比npm install更稳定
RUN npm ci --silent
# 拷贝源码（.dockerignore已排除node_modules等无关文件，不会覆盖容器内依赖）
COPY . .
# 执行项目构建，生成静态产物
RUN npm run build

# 运行阶段：仅保留运行需要的内容
FROM node:18-alpine
WORKDIR /app
# 全局安装静态文件服务
RUN npm install --location=global serve
# 仅从构建阶段拷贝最终生成的静态产物，不需要带源码和node_modules
COPY --from=builder /app/build ./build
EXPOSE 3000
# 直接启动静态服务，不再跑开发模式
CMD ["serve", "-s", "build", "-l", "3000"]

3. 修正构建命令，添加--load参数确保构建的arm64镜像正确导入本地镜像库：

docker buildx build . --tag frontend --platform linux/arm64 --load

4. 本地验证镜像可用性：

# 确认镜像架构
docker image inspect frontend --format '{{.Os}}/{{.Architecture}}'
# 本地模拟运行，确认无报错
docker run --rm -p 8016:3000 frontend

本地访问8016端口确认服务正常后，再按原有流程打标签推送到ECR，EC2实例拉取镜像后即可正常运行。

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