Docker build执行npm install报错：npm: not found问题求助

错误根源 #

1. 基础镜像无Node.js环境：你使用的eclipse-temurin:11是Java专用镜像，默认未安装Node.js和npm，执行npm命令自然会提示"not found"。
2. Dockerfile步骤顺序错误：原文件中RUN npm install在COPY package*.json之前，此时工作目录没有package.json依赖文件，就算安装了npm，这一步也会执行失败。

解决方案分两种场景 #

场景1：纯Node.js应用（你的CMD是npm start，大概率属于这种） #

直接使用Node官方镜像作为基础镜像，无需Java环境：

# 使用Node官方镜像，可根据项目需求替换为对应版本（如16、18）
FROM node:18-bookworm@sha256:8a8b4ff6b1e3d8f8e3e142c9e492e5b028f964e8a55f79d331194ddf3f42e4e5
WORKDIR /usr/src/app

# 先拷贝package文件，利用Docker缓存优化构建速度
COPY package*.json ./
RUN npm install

# 再拷贝项目其他代码
COPY . .

EXPOSE 3000
CMD [ "npm", "start" ]

场景2：确实需要Java+Node混合环境 #

如果你的项目同时依赖Java和Node.js（比如Java后端+Node前端构建），则在Java镜像中安装Node.js和npm：

FROM eclipse-temurin:11@sha256:a0abc98a9994ad188df7fd5755e078fe9b67b1f4c77ebdd9a51b0a16f2e4b9e3
WORKDIR /usr/src/app

# 安装Node.js和npm（基于Debian的镜像，适配eclipse-temurin）
RUN apt-get update && \
    apt-get install -y --no-install-recommends nodejs npm && \
    # 清理apt缓存，减小镜像体积
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

# 先拷贝package文件，利用缓存
COPY package*.json ./
RUN npm install

# 拷贝项目代码
COPY . .

EXPOSE 3000
CMD [ "npm", "start" ]

验证修复 #

重新执行构建命令：

docker build . -t patrick/id-mock

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