Docker镜像构建失败：npm i报错及bash -i -c 'npm i'无响应求助

问题背景 #

执行docker image build --file Dockerfile --tag front ./构建镜像时，RUN npm i步骤出现exit code:127错误；将该行替换为RUN bash -i -c 'npm i'后，构建进程一直无法结束。

Dockerfile内容 #

FROM ubuntu:22.04

WORKDIR /root/app/frontend

COPY . .

ENV APP_NAME app.com
ENV CONTAINER_PORT 80
ENV NODE_VERSION v20.10

EXPOSE $CONTAINER_PORT

# utils
RUN apt-get update \
    && apt-get install -y systemd \
    && apt-get install -y curl \
    && apt-get install -y sudo \
    && apt-get install -y git \
    && apt-get install -y vim \
    && apt-get install -y nginx

# nvm settings
RUN git clone https://github.com/nvm-sh/nvm.git /root/.nvm \
    && chmod -R 777 /root/.nvm/ \ 
    && bash /root/.nvm/install.sh \
    && bash -i -c 'nvm ls-remote' \ 
    && bash -i -c 'nvm install $NODE_VERSION' \
    && bash -i -c 'nvm use $NODE_VERSION' 

# nginx settings
RUN sudo rm /etc/nginx/sites-available/default \
    && sudo rm /etc/nginx/sites-enabled/default \
    && bash ./.nginx/nginx.sh \
    && ln -s /etc/nginx/sites-available/$APP_NAME /etc/nginx/sites-enabled/$APP_NAME \
    && gpasswd -a www-data root \
    && chmod g+x /root && chmod g+x /root/app && chmod g+x /root/app/frontend

RUN chmod -R 777 /root/.npm/ 
RUN npm i

CMD ["nginx", "-g", "daemon off;"]

错误信息 #

39 | >>> RUN npm i
ERROR: failed to solve: process "/bin/sh -c npm i" did not complete successfully: exit code: 127

错误原因 #

1. exit code 127：系统找不到npm命令。nvm安装的Node.js和npm仅在交互式bash shell中生效，因为nvm的初始化脚本被写入~/.bashrc，而Docker默认用非交互式shell执行RUN命令，不会加载.bashrc，导致npm不在环境变量PATH中。
2. bash -i -c卡住：交互式shell（-i参数）会尝试读取终端输入，但Docker构建过程无交互式终端，可能导致进程等待输入而卡住；另外npm i若遇到需要用户确认的依赖协议，也会在无交互环境下挂起。

解决方案 #

方案一：直接安装Node.js（推荐，避开nvm环境问题） #

放弃nvm，通过官方源直接安装Node.js，确保npm加入系统PATH：
修改Dockerfile中的nvm安装部分为：

# 安装Node.js和npm（替代nvm）
RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
    && apt-get install -y nodejs

安装完成后，RUN npm i可直接正常执行。

方案二：手动加载nvm环境变量 #

若必须使用nvm，在执行npm i前手动加载nvm初始化脚本，确保环境变量生效：
将原RUN npm i替换为：

RUN source /root/.nvm/nvm.sh \
    && npm i

或：

RUN bash -c 'source /root/.nvm/nvm.sh && npm i'

此方式无需交互式shell，既解决命令找不到的问题，又避免卡住。

方案三：使用Node.js官方镜像作为基础镜像 #

若项目无需基于Ubuntu 22.04，直接用Node.js官方镜像可省去Node环境配置：

FROM node:20.10-bullseye

WORKDIR /root/app/frontend

COPY . .

ENV APP_NAME app.com
ENV CONTAINER_PORT 80

EXPOSE $CONTAINER_PORT

# 安装nginx
RUN apt-get update \
    && apt-get install -y nginx

# nginx settings（保留原有内容）
RUN rm /etc/nginx/sites-available/default \
    && rm /etc/nginx/sites-enabled/default \
    && bash ./.nginx/nginx.sh \
    && ln -s /etc/nginx/sites-available/$APP_NAME /etc/nginx/sites-enabled/$APP_NAME \
    && gpasswd -a www-data root \
    && chmod g+x /root && chmod g+x /root/app && chmod g+x /root/app/frontend

RUN npm i

CMD ["nginx", "-g", "daemon off;"]

官方镜像已配置好Node和npm环境变量，无需额外处理。

额外优化建议 #

• 移除不必要依赖：systemd在Docker容器中通常无用，vim、git若仅构建时使用，可考虑精简或清理；
• 合并RUN命令减少镜像层数；
• 给npm i添加--no-interactive参数：npm i --no-interactive，避免因等待用户输入卡住。

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