命令行与文本处理 / 系统课时
为什么脚本手工执行正常但 Cron 失败
为什么脚本手工执行正常但 Cron 失败
脚本在终端里运行正常,却放进 Cron 后报“command not found”、找不到文件或读不到变量,通常不是 Cron 随机失效,而是执行环境不同。本节用一套固定排查顺序定位 PATH、工作目录和环境变量问题,并把脚本改成不依赖登录 Shell 的写法。
学习目标
- 区分交互式 Shell 与 Cron 的关键环境差异
- 定位命令路径、工作目录和变量缺失问题
- 编写对 Cron 环境更稳健的脚本
先比较两种执行环境
在终端中,Shell 往往已经加载了用户配置文件,因此 PATH、代理、语言环境和业务变量都可能存在。Cron 通常只提供较精简的环境,且不会按交互登录流程加载你的 Shell 初始化文件。
可以先准备一个诊断脚本,把关键环境写出来。
#!/usr/bin/env bash
set -u
echo "time=$(date '+%Y-%m-%d %H:%M:%S %z')"
echo "pwd=$(pwd)"
echo "home=${HOME:-<UNSET>}"
echo "shell=${SHELL:-<UNSET>}"
echo "path=${PATH:-<UNSET>}"
printf 'tar='
command -v tar || true预期结果:脚本会输出当前时间、工作目录、关键环境变量以及 tar 的实际命令路径;缺失变量会显示为 <UNSET>。
保存为 <PATH>/cron-env.sh 后先手工执行。
/bin/bash <PATH>/cron-env.sh预期输出
time=<TIME>
pwd=<PATH>
home=<PATH>
shell=<PATH>
path=<PATH>
tar=<PATH>/tar再把同一脚本临时加入 Cron,并把输出重定向到文件;几分钟后对比两份结果。不同系统的默认值可能不同,重点看哪些变量缺失、PATH 是否变短,以及工作目录是否与你手工执行时不同。
优先修复命令路径问题
最常见的症状是 Cron 日志中出现 command not found。原因通常是命令安装在 /usr/local/bin、语言版本管理器目录或其他只在登录 Shell 中加入的路径。
比起依赖 ~/.bashrc,定时脚本更适合在开头显式设置所需 PATH,或者对关键命令使用绝对路径。
#!/usr/bin/env bash
set -euo pipefail
PATH=/usr/local/bin:/usr/bin:/bin
export PATH
echo "tar_path=$(command -v tar)"预期输出
tar_path=<PATH>/tar关键验证点是 command -v tar 能返回实际路径;若为空,说明当前 PATH 仍未包含该命令所在目录。
不要依赖当前工作目录
手工运行脚本时,你可能先 cd 到项目目录,所以 ./config.env、./data 之类相对路径都能找到。Cron 启动任务时不应假设当前目录与手工执行时相同。
更稳健的做法是让脚本主动切换到自身所在目录,再访问相对文件。
#!/usr/bin/env bash
set -euo pipefail
PATH=/usr/local/bin:/usr/bin:/bin
export PATH
SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
cd "$SCRIPT_DIR"
test -f "./config.env"
echo "workdir=$(pwd)"
echo "config=found"预期输出
workdir=<PATH>
config=found这里的 <PATH> 应是脚本所在目录。若 config.env 不存在,test -f 会让脚本直接失败,错误位置比后续业务命令“读到空配置”更容易定位。
显式提供业务变量
终端里可用的 API_URL、BACKUP_ROOT 等变量,可能来自 ~/.profile、Shell 启动脚本或手工 export。Cron 不应隐式依赖这些来源。
对于少量固定变量,可以直接写在 crontab 条目前面;对于较多配置,可以让脚本显式读取一个权限受控的 Shell 配置文件。下面是 crontab 片段:
PATH=/usr/local/bin:/usr/bin:/bin
BACKUP_ROOT=/srv/backup
15 2 * * * /bin/bash <PATH>/backup.sh >> <PATH>/backup-cron.log 2>&1这是配置片段。保存后用下面命令检查 Cron 实际看到的条目。
crontab -l预期输出
PATH=/usr/local/bin:/usr/bin:/bin
BACKUP_ROOT=/srv/backup
15 2 * * * /bin/bash <PATH>/backup.sh >> <PATH>/backup-cron.log 2>&1按固定顺序定位失败
遇到“手工正常、Cron 失败”时,先查看任务自己的标准错误日志,再依次检查:命令是否能通过当前 PATH 找到、脚本是否使用相对路径、依赖变量是否真实存在、目标文件和目录是否有权限。
不要一开始就把所有用户初始化文件都 source 进定时脚本。那会把交互环境中的别名、版本管理器和副作用一起带入 Cron,问题反而更难复现。让脚本明确声明路径、目录和变量依赖,通常比“模拟登录 Shell”更稳定,也更容易审计。