手动执行成功而crontab失败，90%以上是环境变量缺失所致——crontab默认path极简且不加载bash配置文件；可通过env记录对比确认，推荐在crontab顶部统一设置path、shell、home等变量，或对单任务显式指定path/绝对路径，并避免source ~/.bashrc、相对路径等常见错误。
手动执行脚本成功、crontab自动执行失败，90%以上是环境变量缺失导致的——尤其是PATH不包含python3、node、mysqldump等命令的实际路径。crontab默认只加载极简环境（PATH通常仅为/usr/bin:/bin），完全不读取~/.bashrc或/etc/profile。
确认是否真是环境变量问题
在crontab里加一行临时诊断任务：
-
* * * * * env > /tmp/cron_env.txt 2>&1（每分钟记录一次实际运行环境） - 等待1分钟后，执行
cat /tmp/cron_env.txt | grep PATH，对比你手动运行env | grep PATH的结果 - 若crontab里的PATH明显更短（比如缺
/usr/local/bin或~/.local/bin），就坐实了环境变量问题
在crontab顶部统一设置关键变量
这是最稳妥、一劳永逸的方式。执行crontab -e，在所有任务之前添加：
-
PATH=/usr/local/bin:/usr/bin:/bin:/home/youruser/.local/bin:/opt/python3.11/bin（把which python3、which node等返回的路径都填进去） -
SHELL=/bin/bash（避免默认用/bin/sh导致语法不兼容） -
HOME=/home/youruser（确保~展开和配置文件路径正确） - 如需Python模块路径，可追加
PYTHONPATH=/home/youruser/myproject
注意：等号前后不能有空格；变量名不带$；改完保存，所有后续任务自动继承。
对单个任务做最小化修复
如果只想快速修好某一条任务，不必动全局配置：
- 用
env显式传入PATH：0 2 * * * env PATH="/usr/bin:/bin:/home/youruser/.local/bin" /usr/bin/python3 /home/youruser/script.py - 或直接写绝对路径调用关键命令：
0 2 * * * /usr/bin/python3 /home/youruser/script.py >> /var/log/script.log 2>&1 - 查绝对路径方法：
which python3、which pip3、which node，全部列进PATH或直接用
避免踩坑的硬性建议
有些常见做法看似省事，实则隐患大：
- 别在crontab里写
source ~/.bashrc——non-login shell下可能失效，且依赖文件权限和执行顺序 - 别用相对路径（如
./script.sh或config.json）——crontab当前工作目录是$HOME，不是脚本所在目录 - 务必重定向输出：
0 2 * * * /path/to/script.sh >> /var/log/script.log 2>&1，否则失败时无声无息 - 脚本第一行明确指定解释器：
#!/bin/bash，并在开头export所需变量（如export PATH=...）
