cron执行脚本无效主因是环境变量缺失,需显式设置PATH、HOME等并用绝对路径;推荐封装为shell脚本统一管理环境与逻辑,调试时直接运行脚本或对比env输出。

cron 执行脚本但没效果,大概率是环境变量缺失——crond 启动时用的是极简 shell 环境(通常只有 /usr/bin:/bin),不加载用户 profile、bashrc,PATH、HOME、LANG 等全都不一样,导致命令找不到、路径错误、编码异常或权限失败。
显式指定完整路径 + 显式设置关键环境变量
在 crontab 中每行任务前手动 export 必需变量,尤其 PATH 和 HOME;所有命令用绝对路径(which python3、which pip 查准):
# 示例:每天 8 点运行 Python 脚本 0 8 * * * export PATH="/usr/local/bin:/usr/bin:/bin"; export HOME="/home/username"; /usr/bin/python3 /home/username/scripts/job.py >> /home/username/logs/job.log 2>&1
-
PATH 至少包含
/usr/local/bin:/usr/bin:/bin(常见命令所在) - HOME 必须设对,否则某些工具(如 git、ssh)读不到 ~/.ssh/config 或 ~/.gitconfig
- Python、Node、Java 等运行时务必用
which xxx查真实路径,别写python3或node
改用 shell 包装脚本(推荐长期维护场景)
把环境设置和主逻辑拆进一个可执行 shell 脚本,crontab 只调它。清晰、易调试、可复用:
# /home/username/scripts/run_job.sh #!/bin/bash export PATH="/usr/local/bin:/usr/bin:/bin:/home/username/.local/bin" export HOME="/home/username" export LANG="en_US.UTF-8" cd /home/username/scripts || exit 1 /usr/bin/python3 ./job.py >> ./logs/job.log 2>&1
- 给脚本加执行权限:
chmod +x /home/username/scripts/run_job.sh - crontab 写法:
0 8 * * * /home/username/scripts/run_job.sh - 调试时直接终端执行该脚本,输出和 cron 完全一致,问题一目了然
验证 cron 环境的最快方法
临时加一条 cron,导出当前 cron 的真实环境,对比你登录时的环境:
# 加到 crontab(比如每分钟一次,跑完删掉) * * * * * env > /tmp/cron_env.txt 2>&1
- 等一分钟,查看
/tmp/cron_env.txt,重点关注 PATH、HOME、SHELL、LANG - 终端执行
env > /tmp/my_env.txt,用diff /tmp/cron_env.txt /tmp/my_env.txt直观看出缺什么 - 特别注意:cron 不读 ~/.bashrc,也不触发交互式 shell 的初始化逻辑
其他高频坑点
-
路径是相对 cron 的工作目录 —— 默认是用户 home 目录,脚本里用
cd /xxx切到项目根再操作,别依赖“当前路径” -
重定向日志必须用绝对路径,
> log.txt会写到 home 目录下,容易找不到 - 密码或密钥类操作(如 ssh、git pull)需免密且指定 key 路径,因为 cron 没有 tty,也无法触发 ssh-agent
- 中文或特殊字符报错?补上
export LANG=en_US.UTF-8或对应 locale










