Docker容器中NVM安装Node.js v8.17.0后提示node: not found问题排查

问题描述 #

基于openjdk:8-alpine构建Docker容器，通过NVM安装Node.js v8.17.0（lts/carbon），但构建完成进入容器执行node -v时，出现node: not found错误。原Dockerfile内容如下：

FROM openjdk:8-alpine

*some java logic*

RUN apk update && apk add bash curl

WORKDIR ./ui

#nvm is installed here
RUN mkdir /usr/local/nvm
ENV NVM_DIR /usr/local/nvm

#installing nvm as mentioned in official website
RUN wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash

RUN . /usr/local/nvm/nvm.sh && nvm install lts/carbon

ENV PATH "/usr/local/nvm/versions/node/v8.17.0/bin:$PATH"

问题原因 #

• Alpine默认shell不兼容：Alpine Linux默认使用ash shell，而NVM的初始化逻辑依赖bash特性。即便安装了bash，容器启动时默认还是ash，无法正确加载NVM的环境配置，导致手动设置的PATH在实际shell环境中不生效。
• NVM初始化未持久化：单独在RUN命令中执行. /usr/local/nvm/nvm.sh仅在当前构建层有效，容器启动后新的shell会话不会自动执行该脚本，Node的可执行文件路径无法被加入到当前shell的PATH中。

修正后的Dockerfile #

FROM openjdk:8-alpine

# 保留你的Java逻辑
*some java logic*

# 安装依赖并将bash设为默认shell
RUN apk update && apk add --no-cache bash curl && \
    ln -sf /bin/bash /bin/sh

WORKDIR /ui

# 定义NVM和Node版本变量
ENV NVM_DIR /usr/local/nvm
ENV NODE_VERSION lts/carbon

# 安装NVM并指定Node版本
RUN wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash && \
    . "$NVM_DIR/nvm.sh" && \
    nvm install "$NODE_VERSION" && \
    nvm alias default "$NODE_VERSION" && \
    nvm use default

# 设置全局PATH并持久化NVM初始化
ENV PATH "$NVM_DIR/versions/node/$NODE_VERSION/bin:$PATH"
RUN echo ". $NVM_DIR/nvm.sh" >> /etc/profile.d/nvm.sh && \
    chmod +x /etc/profile.d/nvm.sh

关键修正说明 #

1. 切换默认shell为bash：通过ln -sf /bin/bash /bin/sh将容器默认shell改为bash，确保NVM的环境变量能被正确解析和加载。
2. 持久化NVM初始化：将NVM的初始化脚本写入/etc/profile.d/nvm.sh，每次启动容器进入shell时都会自动执行该脚本，保证Node命令在所有会话中可用。
3. 合并构建步骤：将NVM安装、Node安装的命令合并到同一个RUN中，减少镜像层数的同时，确保所有操作在同一个环境上下文完成，避免环境变量失效。

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