Jenkins执行脚本时ifconfig/ip a命令未找到问题咨询

核心原因 #

• 环境变量PATH不匹配：Jenkins任务默认以jenkins系统用户身份运行，这个用户的PATH环境变量通常不包含/sbin、/usr/sbin这类系统工具目录——而ifconfig、ip命令正好存放在这些路径下。你手动登录终端用的是普通用户或root，PATH里已经包含了这些目录，所以能正常执行命令。
• 服务环境受限：如果Jenkins是通过systemd等服务管理器启动的，它的执行环境会被重置，不会继承登录用户的shell配置（比如.bashrc、.profile里的PATH设置），导致命令路径找不到。

解决办法 #

• 用命令绝对路径执行：先在终端执行which ifconfig或which ip拿到命令的绝对路径（比如/sbin/ifconfig），然后在Jenkins脚本里直接写绝对路径，比如：

  /sbin/ifconfig
  # 或者
  /usr/sbin/ip a
  

• 临时在脚本里添加PATH：在脚本开头加上一行，把缺失的路径加入环境变量：

  export PATH=$PATH:/sbin:/usr/sbin
  ifconfig
  

• 修改Jenkins全局环境变量：进入Jenkins的「Manage Jenkins」→「Configure System」，找到「Global properties」，勾选「Environment variables」，添加一条变量：
  • 名称：PATH
  • 值：$PATH:/sbin:/usr/sbin（保留原有PATH的同时补充新路径）

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