构建React应用Docker镜像时npm run build执行失败求助

问题分析 #

报错明确提示构建进程过早退出，核心原因是内存不足，结合Windows 11 + Docker Desktop的环境，大概率是Docker容器内存配额不足，或是Alpine镜像的内存管理特性导致构建资源不够。

具体解决步骤 #

• 调高Docker Desktop内存配额
  打开Docker Desktop，进入Settings > Resources > Advanced，把内存分配从默认的2GB调高到4GB及以上，保存后重启Docker。React生产构建对内存需求较高，依赖较多的项目尤其需要足够的资源。

• 给构建命令追加内存限制参数
  修改Dockerfile中的构建步骤，强制Node进程使用更大的内存空间：

  RUN NODE_OPTIONS="--max-old-space-size=4096" npm run build:qa
  

  该参数指定Node最多使用4GB内存，避免构建时因内存溢出被系统强制终止。

• 替换基础镜像为非Alpine版本
  Alpine镜像体积小但兼容性较差，换成官方node:16（Debian基础）镜像，构建稳定性会显著提升：

  FROM node:16
  
  WORKDIR /app/app-v2
  
  COPY .npmrc ./
  COPY package.json ./
  RUN npm install --legacy-peer-deps
  COPY . .
  RUN NODE_OPTIONS="--max-old-space-size=4096" npm run build:qa
  RUN rm -r node_modules
  
  CMD ["npm", "run", "serve:qa"]
  

• 先验证本地构建是否正常
  在项目根目录本地执行npm run build:qa，如果本地也失败，说明问题不在Docker环境，需要排查项目依赖（比如未安装的依赖、.env.qa配置错误）或React脚本的版本兼容性。

内容的提问来源于stack exchange，提问作者Mohammad Shawer Khandariya