Jenkins Docker代理执行React构建时Node版本不符问题

Jenkins流水线执行sh步骤时使用的是非交互式非登录Shell，这类Shell默认不会自动加载~/.bashrc文件。你的Dockerfile.agent虽然把nvm配置写入了.bashrc，但流水线执行命令时未加载该配置，导致系统优先使用apt安装的Node.js v12（而非nvm安装的v20），最终引发依赖兼容问题。

另外，Dockerfile中单独的RUN . $HOME/.bashrc命令无效，因为每个RUN指令都在独立的Shell进程中执行，环境变量不会保留到后续容器运行阶段。

以下两种方案均可解决问题，推荐方案一（全局生效，无需修改Jenkinsfile）：

方案一：修改Dockerfile.agent，将nvm安装的Node.js加入全局PATH #

直接让系统全局能访问到nvm安装的Node.js，无需依赖Shell配置文件。修改后的Dockerfile.agent如下：

FROM jenkins/agent:latest

USER root

# Install dependencies
RUN apt-get update && \
    apt-get install -y docker awscli default-jdk && \
    rm -rf /var/lib/apt/lists/*

# Install nvm and latest Node.js
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash \
    && . ~/.nvm/nvm.sh \
    && nvm install node \
    && node -e "console.log('Running Node.js ' + process.version)" \
    # 将nvm安装的node和npm软链接到系统全局目录
    && ln -s "$(nvm which node)" /usr/local/bin/node \
    && ln -s "$(npm bin -g)/npm" /usr/local/bin/npm

# Fix npm permissions
RUN mkdir -p /.npm
RUN chown -R 1002:1002 /.npm

USER 1002:1002

注：移除了原Dockerfile中apt安装的npm，避免和nvm的版本冲突；通过软链接让系统全局PATH能找到nvm的Node.js。

方案二：在Jenkinsfile的sh步骤中手动加载.bashrc #

如果不想修改Dockerfile，可以在执行npm命令前手动加载nvm配置：

stage('Build React App') {
    steps {
        script {
            sh ". ~/.bashrc && npm ci"
            sh ". ~/.bashrc && npm run build"
        }
    }
}

修改后重新触发流水线，在npm ci步骤前添加sh "node -v"命令，确认输出的Node.js版本为v20即可。

内容的提问来源于stack exchange，提问作者Aspiring Dev 23000