命令行与文本处理 / 系统课时

为什么脚本手工执行正常但 Cron 失败

为什么脚本手工执行正常但 Cron 失败

脚本在终端里运行正常,却放进 Cron 后报“command not found”、找不到文件或读不到变量,通常不是 Cron 随机失效,而是执行环境不同。本节用一套固定排查顺序定位 PATH、工作目录和环境变量问题,并把脚本改成不依赖登录 Shell 的写法。

学习目标

  • 区分交互式 Shell 与 Cron 的关键环境差异
  • 定位命令路径、工作目录和变量缺失问题
  • 编写对 Cron 环境更稳健的脚本

先比较两种执行环境

在终端中,Shell 往往已经加载了用户配置文件,因此 PATH、代理、语言环境和业务变量都可能存在。Cron 通常只提供较精简的环境,且不会按交互登录流程加载你的 Shell 初始化文件。

可以先准备一个诊断脚本,把关键环境写出来。

bash
#!/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 后先手工执行。

bash
/bin/bash <PATH>/cron-env.sh

预期输出

text
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,或者对关键命令使用绝对路径。

bash
#!/usr/bin/env bash
set -euo pipefail

PATH=/usr/local/bin:/usr/bin:/bin
export PATH

echo "tar_path=$(command -v tar)"

预期输出

text
tar_path=<PATH>/tar

关键验证点是 command -v tar 能返回实际路径;若为空,说明当前 PATH 仍未包含该命令所在目录。

不要依赖当前工作目录

手工运行脚本时,你可能先 cd 到项目目录,所以 ./config.env、./data 之类相对路径都能找到。Cron 启动任务时不应假设当前目录与手工执行时相同。

更稳健的做法是让脚本主动切换到自身所在目录,再访问相对文件。

bash
#!/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"

预期输出

text
workdir=<PATH>
config=found

这里的 <PATH> 应是脚本所在目录。若 config.env 不存在,test -f 会让脚本直接失败,错误位置比后续业务命令“读到空配置”更容易定位。

显式提供业务变量

终端里可用的 API_URL、BACKUP_ROOT 等变量,可能来自 ~/.profile、Shell 启动脚本或手工 export。Cron 不应隐式依赖这些来源。

对于少量固定变量,可以直接写在 crontab 条目前面;对于较多配置,可以让脚本显式读取一个权限受控的 Shell 配置文件。下面是 crontab 片段:

text
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 实际看到的条目。

bash
crontab -l

预期输出

text
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”更稳定,也更容易审计。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为什么脚本手工执行正常但 Cron 失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通