手动敲能跑,cron 一跑就 command not found?聊聊 PATH 到底从哪来
前情:同一个工具,SSH 进去手动执行好好的,写进脚本后台跑就说找不到;拷到另一台机器更邪门,
ls能看到文件,command -v却是空的。本文把三种 shell 各读哪些配置文件、PATH 差在哪,用一个最小例子量出来。
一、先看现象
造一个假工具,装在一个不在 PATH 里的目录,然后写进 ~/.bashrc:
shell
$ mkdir -p $HOME/bin
$ printf '#!/bin/bash\necho "我是 mytool v1,跑起来了"\n' > $HOME/bin/mytool
$ chmod 775 $HOME/bin/mytool
$ echo 'export PATH="$PATH:$HOME/bin"' >> ~/.bashrc
然后分别用三种方式调用:
ini
=== 1. 登录 shell(bash -lc,等价于你 ssh 进去那一刻)===
我是 mytool v1,跑起来了
PATH 长度=1967
=== 2. 非交互 shell(bash -c,等价于脚本里调用)===
找不到 mytool
PATH 长度=1853
=== 3. cron 的最小环境(PATH 只有 /usr/bin:/bin)===
找不到 mytool
PATH=/usr/bin:/bin
同一个用户、同一台机器、同一个命令。差别只在"这个 shell 是怎么起来的"。
二、PATH 是每个 shell 自己拼出来的
PATH 不是系统全局的一份,而是每个 shell 进程自己的环境变量,由"启动时读了哪些文件 + 从父进程继承了什么"决定。
三种启动方式的差别:
| 启动方式 | 典型场景 | 读哪些文件 | 能拿到 .bashrc 里的 PATH 吗 |
|---|---|---|---|
| 登录 shell | ssh user@host、su -、bash -l |
/etc/profile、~/.bash_profile、~/.bash_login、~/.profile |
间接(~/.bash_profile 里通常会 . ~/.bashrc) |
| 交互非登录 | 打开一个终端窗口 | /etc/bashrc、~/.bashrc |
能 |
| 非交互 | bash script.sh、systemd、cron、ssh host 'cmd' |
基本什么都不读 (除非 BASH_ENV) |
不能 |
看第三行------非交互 shell 基本不读任何配置文件 。而你的 cron 任务、systemd 服务、ssh host 'command'、后台 nohup 起来的东西,全属于这一类。
所以"手动敲能跑"的真相是:你那个交互终端已经把 $HOME/bin 加进 PATH 了,从它派生的子进程继承这份 PATH,所以脚本也跟着能用。一旦换了爹(cron、systemd、另一台机器),这份 PATH 就没了。
上面那组数字也能印证:1967 − 1853 = 114 ,正好是 export PATH="$PATH:/home/xxx/bin" 这一行的长度。
三、第二层坑:脚本里解析了变量,但子进程不认
这个坑我踩得最久。当时写了个包装:
bash
IPMITOOL_BIN=/mnt/share/tools/bin/ipmitool
$IPMITOOL_BIN -I lanplus -H 192.168.101.5 -U admin -P admin power status
我自己调用没问题。但脚本里还有一堆地方是裸写 ipmitool:
bash
poweroff.sh # 里面就一句 ipmitool ... chassis power off
这些脚本被当子进程调起来,继承的是 PATH ,不知道你 Shell 里那个 IPMITOOL_BIN 变量。
shell
$ command -v ipmitool
(空)
$ rpm -q ipmitool
package ipmitool is not installed
$ find /mnt/share -name 'ipmitool*'
/mnt/share/tools/bin/ipmitool
工具在,只是找不到。command -v 空、rpm -q 未装,都只说明"PATH 里没有",不说明"没装"。
这个区别很重要:一次我差点直接 yum install,但机器压根没外网,yum 会卡在那里转圈。
四、第三层坑:检查的是"名字",不是"能不能执行"
修的时候我写过一个错误的检查:
bash
case "$IPMITOOL_BIN" in
*/ipmitool) return 0 ;; # 路径以 ipmitool 结尾就当"有"
esac
这段的意思是"只要变量看着像 ipmitool 的路径,就认为环境没问题"。但目录不在 PATH 里,真正执行的时候还是 command not found。
更糟的是它造出了假通过 :电源命令根本没发出去,设备没断电;而后面那句 wait_for_all_cpus_uptime 检查的是 CPU uptime------刀片本来就没下电,uptime 当然正常。于是整轮报 Succ。
设备没断电,结论是通过。 这种假阳性的代价比报错大得多,因为它让你相信测试覆盖到了。
唯一可信的检查是 command -v:
bash
command -v ipmitool >/dev/null || { echo "[result] Fail (ipmitool 不在 PATH)"; exit 3; }
它问的是"shell 现在能不能找到并执行这个名字",而不是"我看这个字符串像不像"。
五、正确写法:让脚本自己负责 PATH
不要指望运行环境帮你准备好一切。脚本被谁调用是它管不了的,所以 PATH 得自己补。
bash
TOOL_DIR="/mnt/share/tools/bin"
case ":$PATH:" in
*":$TOOL_DIR:"*) ;; # 已经在里面,不重复加
*) export PATH="$TOOL_DIR:$PATH" ;; # 不在就前置
esac
command -v ipmitool >/dev/null || { echo "[result] Fail: ipmitool 不在 PATH"; exit 3; }
三个细节:
1. 用 case ":$PATH:" in 而不是 grep
首尾加冒号是为了让"第一个元素"和"最后一个元素"也能匹配上 :dir:。不加的话,PATH 开头那个目录永远匹配不到。
2. 必须幂等
这个脚本可能在共享盘上、可能被同一台机器加载两次、可能被人 source 后又执行。重复 export 会让 PATH 越来越长,最后超出长度限制。
3. 补完立刻 command -v 验一遍
补 PATH 这个动作本身也可能错------目录名写错、文件没有执行位、软链断了。command -v 是唯一能一次覆盖这几种情况的检查。
六、不同调用方,各自的写法
cron:在 crontab 顶部显式声明,别依赖继承
javascript
PATH=/usr/local/bin:/usr/bin:/bin
0 2 * * * /opt/scripts/night_run.sh >> /var/log/night.log 2>&1
systemd:写进 unit,不要指望 profile
javascript
[Service]
Environment=PATH=/usr/local/bin:/usr/bin:/bin
Environment=IPMITOOL_BIN=/mnt/share/tools/bin/ipmitool
ExecStart=/opt/scripts/night_run.sh
ssh 远程执行 :ssh host 'cmd' 是非交互非登录 shell,PATH 极简
ini
# 别这样
ssh root@192.168.1.5 'ipmitool power status'
# 这样
ssh root@192.168.1.5 'export PATH=/mnt/share/tools/bin:$PATH; ipmitool power status'
nohup 后台 :继承的是"启动它的那个 shell"的 PATH,所以能用;但一旦这个脚本被别的脚本调起,链条一长就断了。还是自己补最稳。
七、清单
-
command -v空、rpm -q未装,先find一遍再决定装不装------很多是"没在 PATH"而不是"没装"。 - 交互 shell 能跑不代表脚本能跑。cron / systemd /
ssh host 'cmd'/ nohup 都是非交互,PATH 极简。 - 脚本里自己补 PATH:
case ":$PATH:"幂等判断 +export前置。 - 补完必须
command -v验证,别用"变量看着像"当检查。 - 检查逻辑不要写成
*/toolname) return 0------那检查的是字符串,不是可执行性。 - cron 顶部写
PATH=,systemd 用Environment=PATH=,都别指望 profile。 - 远程执行用一行
export PATH=...; cmd,或者干脆写绝对路径。 - 工具装在共享盘上时,确认挂载点已经挂上再检查 PATH,否则
find也看不到。
八、完整复现脚本
一个文件,不用下载附件 ,存成 demo.sh 直接跑。它用的是一个假 HOME (./fakehome),不会碰你自己的 .bashrc,放心执行。
bash
#!/bin/bash
# 为什么"手动敲能跑,写进脚本/丢进 cron 就 command not found"
cd "$(dirname "$0")"
# 造一个假的 HOME,绝不碰你自己的 .bashrc
export FAKEHOME="$(pwd)/fakehome"
rm -rf "$FAKEHOME"
mkdir -p "$FAKEHOME/bin"
printf '#!/bin/bash\necho "我是 mytool v1,跑起来了"\n' > "$FAKEHOME/bin/mytool"
chmod 775 "$FAKEHOME/bin/mytool"
printf 'export PATH="$PATH:%s/bin"\n' "$FAKEHOME" > "$FAKEHOME/.bashrc"
printf '. ~/.bashrc\n' > "$FAKEHOME/.bash_profile"
echo "假命令装在: $FAKEHOME/bin/mytool"
echo ""
echo "=== 1. 登录 shell(bash -lc,等价于你 ssh 进去那一刻)==="
HOME="$FAKEHOME" bash -lc 'mytool 2>/dev/null || echo " 找不到 mytool"; echo " PATH 长度=${#PATH}"'
echo ""
echo "=== 2. 非交互 shell(bash -c,等价于脚本里调用)==="
HOME="$FAKEHOME" bash -c 'mytool 2>/dev/null || echo " 找不到 mytool"; echo " PATH 长度=${#PATH}"'
echo ""
echo "=== 3. cron 的最小环境(PATH 只有 /usr/bin:/bin)==="
HOME="$FAKEHOME" env -i PATH=/usr/bin:/bin bash -c 'mytool 2>/dev/null || echo " 找不到 mytool"; echo " PATH=$PATH"'
echo ""
echo "=== 4. 那为什么"手动敲就行"?因为你的交互 shell 已经把 PATH 带下来了 ==="
echo " 当前 shell 的 PATH 长度=${#PATH}"
echo " bash -c 继承它 → 所以在终端里跑脚本总是好的"
echo " cron / systemd / 别的机器 → 没有这份 PATH"
echo ""
echo "=== 5. 脚本里自己补 PATH(唯一可靠的写法)==="
cat > selfpath.sh <<'EOF'
#!/bin/bash
TOOL_DIR="/opt/mytools/bin"
case ":$PATH:" in
*":$TOOL_DIR:"*) ;;
*) export PATH="$TOOL_DIR:$PATH" ;;
esac
command -v mytool >/dev/null || { echo "[result] Fail: mytool 不在 PATH"; exit 3; }
EOF
echo " ------ selfpath.sh 片段 ------"
sed -n '2,7p' selfpath.sh | sed 's/^/ /'
跑法:
bash
chmod +x demo.sh
./demo.sh
看第 1、2、3 组的 PATH 长度:登录 shell 有 .bashrc 里的那条路径,bash -c 没有,env -i 连 /usr/local/bin 都没有。这就是"手动敲能跑、cron 跑不了"的全部原因。
第 5 组生成的 selfpath.sh 就是可以直接抄进你自己脚本的补 PATH 模板------注意它是幂等的,重复调用不会把同一路径叠好几遍。