未改动的Pipeline报npm command not found导致运行失败问题求助

根因说明 #

在未修改Pipeline配置、且多个node镜像均触发报错的前提下，可直接排除镜像本身未预装npm的可能性，90%以上的同类问题由环境变量PATH被覆盖导致：

部分CI/CD平台的全局配置变更、Pipeline前置步骤的自定义脚本，都可能将node、npm默认的安装路径挤出PATH的检索范围，导致shell无法找到对应命令。

排查步骤 #

• 执行npm命令前，先在Pipeline脚本中插入echo $PATH打印当前路径，对比之前正常运行时的PATH输出，检查是否缺少/usr/local/bin、/usr/bin这类npm默认安装路径
• 排查近期CI/CD平台的全局配置变更，部分平台的全局环境变量注入优先级高于镜像内置变量，即使项目配置未修改，也可能被全局规则覆盖
• 检查Pipeline的所有前置步骤，是否存在修改PATH、修改shell配置文件（.bashrc/.profile等）、卸载系统组件的操作

修复方案 #

• 路径缺失临时修复：在执行npm命令前手动补充路径，示例：
  export PATH=$PATH:/usr/local/bin
  也可直接使用绝对路径调用npm，默认安装路径通常为/usr/local/bin/npm
• 全局配置冲突：联系CI/CD平台管理员确认近期全局配置变更，申请保留node相关路径的检索优先级
• 兜底兼容方案：执行npm命令前先安装npm组件，Debian/Ubuntu系镜像执行：

  apt update && apt install -y --no-install-recommends npm
  

  Alpine系镜像执行：

  apk add --no-cache npm
  

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