Docker中Jenkins构建脚本执行失败：npm命令未找到

这个问题大概率是Jenkins构建任务的环境变量PATH没有包含nodejs的安装路径导致的——虽然你手动切换到jenkins用户能正常执行npm，但Jenkins的构建进程并不会自动加载用户的shell配置（比如~/.bashrc、~/.profile），所以环境变量不完整。

下面是具体的解决方法：

方法1：临时解决——使用npm的绝对路径执行 #

先手动进入容器，用jenkins用户执行以下命令找到npm的绝对路径：

which npm

假设输出是/usr/bin/npm，那么把你的构建脚本改成：

echo 'starting build'
/usr/bin/npm -v

这样就能直接通过绝对路径调用npm，绕过环境变量的问题。

方法2：永久解决——在Dockerfile中配置全局环境变量 #

修改你的Dockerfile，在安装完nodejs后，把nodejs的路径添加到系统全局的环境变量里，这样Jenkins构建进程也能读取到：

USER root
RUN apt-get update && \
    apt-get install -y sudo && \
    curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - && \
    apt-get install -y nodejs && \
    # 将node和npm的路径添加到全局环境变量（根据实际路径调整）
    echo "PATH=\$PATH:/usr/bin" >> /etc/environment
USER jenkins

方法3：通过Jenkins全局配置添加环境变量 #

如果不想修改Dockerfile，也可以在Jenkins后台配置全局环境变量：

• 进入Jenkins的「Manage Jenkins」→「Configure System」
• 找到「Global properties」，勾选「Environment variables」
• 添加一个变量：
  • 名称：PATH
  • 值：$PATH:/usr/bin（替换成你实际查到的npm路径）
• 保存配置后，重新运行构建任务即可

另外，顺便优化下你的Dockerfile：把多个RUN命令合并成一个，减少镜像层数，同时清理apt缓存减小镜像大小：

USER root
RUN apt-get update && \
    apt-get install -y sudo && \
    curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - && \
    apt-get install -y nodejs && \
    echo "PATH=\$PATH:/usr/bin" >> /etc/environment && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*
USER jenkins

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