手动模拟定时任务是什么
「手动执行正常、放进定时任务就失败」几乎都出在环境差异上：定时任务运行时环境变量几乎为空、可执行文件搜索路径只有很窄的默认值、没有交互式 shell 的初始化流程、工作目录也不确定。复现的方法就是把这几要素补上再跑一次同一份脚本——用空环境、最小路径、非交互 shell 执行，同时打开执行追踪，多数失败原因当场就能看到。
基本信息
| 适用平台 | GNU/Linux（定时任务与 shell） |
|---|---|
| 复现三要素 | 空环境、最小路径、非交互 shell |
| 常用手段 | 清空环境执行、开启执行追踪、切换到目标用户运行 |
| 常见失败原因 | 找不到命令、相对路径失效、依赖的环境变量缺失 |
| 对账方法 | 打印脚本内关键变量与预期环境对比 |
| 注意 | 切换到目标用户时要带上切换家目录的行为 |
典型使用场景
- 排查手动执行正常但定时任务失败的问题。
- 上线新的定时任务前先做一次环境模拟验证。
- 确认任务运行用户与家目录，避免权限与路径问题。
- 定位脚本依赖的环境变量在定时任务里是否缺失。
- 验证脚本在最小环境下是否真的自洽。
模拟与追踪
模拟与追踪
env -i PATH=/usr/bin:/bin SHELL=/bin/sh /bin/sh -c '/opt/app/job.sh; echo rc=$?'
bash -x /opt/app/job.sh 2>&1 | head -n 60 # 追踪每一步执行
sudo -u www -H env -i PATH=/usr/bin:/bin /opt/app/job.sh # 以目标用户身份跑
echo "PATH=$PATH"; pwd; whoami; date # 打印关键变量做对账
crontab -l | head # 确认任务定义
journalctl -u cron --since today --no-pager | tail -20 # 查看调度报错要素与现象读法
| 要素或现象 | 含义 | 使用要点 |
|---|---|---|
| 空环境 | 几乎没有环境变量 | 多数失败的第一原因 |
| 最小路径 | 只有系统默认目录 | 脚本用命令名而非绝对路径会找不到 |
| 非交互 shell | 不读取交互配置文件 | 依赖别名与交互初始化会失效 |
| 工作目录 | 不固定 | 脚本必须使用绝对路径 |
| 目标用户 | 与登录用户往往不同 | 切换时要带上切换家目录的行为 |
| 执行追踪 | 打印每条命令 | 定位失败步骤最快的方式 |
切换用户时如果不带上切换家目录的行为，家目录仍指向原用户，模拟结果会失真；加上对应参数更接近真实运行环境。
脚本里引入交互式配置文件会带来交互逻辑，在空环境下行为与预期不同；定时任务脚本应只依赖显式导出的变量。
复现时要打印关键变量与预期环境逐条对比，把差异对齐比凭经验猜快得多。