基于Ubuntu镜像的React项目Docker容器启动报错：npm未找到

问题原因 #

你遇到的exec: "npm": executable file not found in $PATH错误，核心原因是Docker的RUN指令在单独的临时shell进程中执行，进程结束后，你设置的NVM环境变量和加载的nvm.sh不会被容器启动时的进程继承。构建阶段能用npm是因为那时候shell还没退出，但容器启动时是全新的进程，PATH里根本找不到nvm安装的node/npm路径。

修复方案 #

方案1：直接安装官方Node.js（推荐，更简洁可靠）

放弃nvm，直接通过apt安装官方维护的Node.js包，这样npm会自动加入系统默认PATH：

FROM ubuntu:latest
WORKDIR /app

# 安装curl并添加Node.js源，然后安装Node.js和npm
RUN apt update && \
    apt-get -y install curl && \
    curl -fsSL https://deb.nodesource.com/setup_lts.x | bash - && \
    apt-get -y install nodejs

# 初始化React-TS项目并安装依赖
RUN npm create vite@latest -y . -- --template react-ts && \
    npm install

EXPOSE 5173
ENTRYPOINT ["npm", "run", "dev"]
CMD ["--", "--host"]

方案2：如果必须用NVM，正确配置环境变量

需要把NVM的加载逻辑写入~/.bashrc，并确保容器启动时能加载这些配置，同时把node的bin目录加入全局PATH：

FROM ubuntu:latest
WORKDIR /app

RUN apt update && \
    apt-get -y install curl && \
    # 安装NVM
    curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash && \
    # 把NVM的初始化命令写入~/.bashrc，确保每次启动shell都加载
    echo 'export NVM_DIR="/root/.nvm"' >> ~/.bashrc && \
    echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc && \
    # 用bash加载NVM后，安装Node.js LTS并初始化项目
    bash -c "source ~/.bashrc && nvm install --lts && npm create vite@latest -y . -- --template react-ts && npm install"

# 手动把Node.js的bin目录加入PATH，避免启动时找不到npm
ENV PATH="/root/.nvm/versions/node/$(bash -c 'source ~/.bashrc && nvm current')/bin:${PATH}"

EXPOSE 5173
# 用bash执行命令，确保加载~/.bashrc中的NVM配置
ENTRYPOINT ["bash", "-c", "npm run dev $0 $1", "--"]
CMD ["--host"]

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