crontab 定时任务静默失败：脚本手动执行成功但 cron 里不运行（PATH 问题排查实录）

问题背景

运维中常见一类诡异故障：备份/定时脚本手动执行一切正常，但 crontab 里却"不跑"或"静默失败"——目录里没有新增文件，/var/log/syslog、/var/log/cron、邮件里也查不到任何报错，仿佛任务被系统"吞掉"。

技术栈：Linux cron / crontab、python:3.11-slim Docker 容器、bash 备份脚本、PATH 环境变量。典型报错特征：日志为空、无 MTA、python3: command not found（但只在 cron 环境触发）。

复现步骤

# 环境：python3 装在 /usr/local/bin/python3（不在 cron 默认 PATH 中）
# 1. 确认 crontab 任务已注册
crontab -l
# * * * * * /bin/bash /workspace/scenario/.../backup.sh

# 2. 确认 cron 守护进程在运行
pgrep -x cron    # 或 ps aux | grep [c]ron

# 3. 手动执行脚本 → 正常，能生成备份文件
bash backup.sh
ls /tmp/backups/   # 能看到 backup-*.txt

# 4. 模拟 cron 的最小化 PATH 环境执行 → 复现失败
env -i PATH=/usr/bin:/bin HOME=/root SHELL=/bin/sh /bin/bash backup.sh
# 输出: python3: command not found；退出码 1

# 5. 等 cron 触发后查看目录 → 只有手动那份，无 cron 自动新增
sleep 65
ls -la /tmp/backups/

根本原因

三层问题叠加，导致故障完全静默：

PATH 缺失（直接根因）：python3 装在 /usr/local/bin/python3，而 cron 执行用户任务时默认 PATH 仅为 /usr/bin:/bin（不含 /usr/local/bin）。脚本用裸命令 python3 依赖 PATH 查找，cron 环境下报 command not found。
crontab 无日志重定向：条目没写 >> logfile 2>&1，cron 默认把 stdout/stderr 用邮件发给用户。
无 MTA（错误彻底丢失）：基于 python:3.11-slim 的容器没装邮件服务，cron 发邮件失败，错误信息永久消失。

结论：cron 每分钟其实都执行了脚本，但每次都因 PATH 失败，且错误无处可查——"静默失败"。

解决办法

1. 让错误"可见"：crontab 加日志重定向

* * * * * /bin/bash /path/to/backup.sh >> /tmp/cron_backup.log 2>&1
MAILTO=""

改完立刻能在日志看到真实错误：python3: command not found。

2. 修复 PATH 根因：脚本顶部显式设置完整 PATH

#!/bin/bash
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
# 建议再用绝对路径/command -v 兜底调用外部命令
PYTHON_BIN="/usr/local/bin/python3"
[ -x "$PYTHON_BIN" ] || PYTHON_BIN="$(command -v python3)"
"$PYTHON_BIN" script.py

3. 固化可观测性：入口脚本统一管理 crontab

在容器 entrypoint 里注册自带 >> log 2>&1 + MAILTO="" 的 crontab，让定时任务默认有日志。

验证

修复前：模拟 cron PATH 执行退出码 1，python3: command not found；
修复后：同一模拟环境执行退出码 0，备份成功；
cron 自动触发：日志记录 备份成功，/tmp/backups/ 每分钟自动新增 backup-*.txt；
错误全程落盘可见，不再静默。

经验与避坑

cron 与交互 shell 的 PATH 不同（cron 默认 /usr/bin:/bin）。凡脚本用到外部命令，建议写绝对路径或在脚本顶部 export PATH。
crontab 条目务必重定向输出（>> logfile 2>&1）。cron 默认靠邮件报错，服务器/容器无 MTA 时错误会静默丢失，极难排查。
排查"手动正常、cron 不跑"：① 确认 cron 进程在跑；② 用 env -i PATH=/usr/bin:/bin ... 模拟 cron 最小环境复现 PATH 问题；③ 临时给 crontab 加日志定位真实报错。
容器里做定时任务，注意精简镜像常缺 MTA、ps/pgrep 等工具，可用 /proc 检查进程，并主动在 entrypoint 里做日志落盘。
用 command -v + 绝对路径兜底查找可执行文件，提升脚本健壮性。

可复现命令

cd scenario/2026-09-03-0800
docker compose up -d --build
docker compose exec cron-app bash
# 修复前按"复现步骤"复现；修复后脚本已更新，重建容器即可看到 cron 每分钟自动生成备份