Docker构建Node.js镜像报错：node-gyp: not found

问题根源 #

Docker构建过程完全在容器内部的独立环境中执行，你本地全局安装的node-gyp不会被带入容器，所以容器内找不到该命令。

具体解决方案 #

• 在容器内安装node-gyp：找到Dockerfile中执行依赖安装的阶段（比如RUN yarn install所在步骤），在其之前添加全局安装命令：

  RUN npm install -g node-gyp
  # 或用yarn安装
  # RUN yarn global add node-gyp
  

• 安装node-gyp依赖的系统编译工具：node-gyp需要Python、make、gcc等工具，基于Debian/Ubuntu的基础镜像中可添加：

  RUN apt-get update && apt-get install -y --no-install-recommends python3 make g++ && rm -rf /var/lib/apt/lists/*
  

• 适配多阶段构建：将上述命令添加到负责安装依赖的阶段（如install阶段），而非最终运行阶段，避免镜像体积冗余。
• 可选：跳过可选依赖：若不需要cpu-features，可修改依赖安装命令：

  RUN yarn install --ignore-optional
  

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