手动敲能跑,cron 一跑就 command not found?聊聊 PATH 到底从哪来

手动敲能跑,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 模板------注意它是幂等的,重复调用不会把同一路径叠好几遍。

相关推荐
bcbnb44 分钟前
Windows 上 iOS 开发接 CI,KXBuild 自托管 runner 出签名 ipa
后端·ios
十有八七1 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下1 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
Resean02232 小时前
Spring 源码分析(一)IOC 容器总览与 refresh() 全景
java·后端·spring
苍何2 小时前
一句话出成片,我搭了个AI视频工厂
后端
bysking3 小时前
GitHub Actions 快速入门+场景实践案例
前端·后端·github
对象存储与RustFS4 小时前
对象锁遇上版本化:删掉的对象还在,真删的又删不掉
后端·docker·云原生
CappuccinoRose6 小时前
Redis 学习文档
redis·后端·学习·缓存·session·非关系型数据库·gossip
我不会起名字3226 小时前
WebSocket 停机与在线状态:Shutdown 返回后还需要清理什么
redis·后端·websocket·go·即时通讯·im·故障排查