宝塔定时任务不执行的主因是脚本环境问题而非周期设置错误；需加#!/bin/bash、用绝对路径调用解释器、显式导出环境变量、启用日志并用timeout控制超时。
宝塔定时任务不执行？先看日志和权限
绝大多数“设了但没跑”的问题，不是频率填错，而是脚本本身在宝塔环境下跑不通。宝塔的定时任务默认用 sh 执行，不加载用户 shell 环境（比如 ~/.bashrc），所以 python、node、composer 这类命令常报 command not found。
实操建议：
- 所有脚本开头加
#!/bin/bash，并在第一行后立即用绝对路径调用解释器，比如/usr/bin/python3 /www/wwwroot/site/script.py - 执行前手动在终端里切到宝塔任务使用的用户（通常是
www）运行一遍：sudo -u www /bin/bash -c "你的命令"，确认无报错 - 务必勾选“记录日志”，出问题直接看
/www/wwwlogs/cron_*.log，别猜 - 避免在命令栏直接写多行逻辑，统一写进 shell 脚本再调用，方便调试和复用
每 5 分钟执行一次但总差几秒？别信面板里的“周期”下拉菜单
宝塔界面里“每 X 分钟”这类选项本质是生成 */X * * * * 的 cron 表达式，它从系统分钟刻度对齐（比如整点、05分、10分），不是从你点击“添加”那一刻开始倒计时。如果你 14:07 添加了“每5分钟”，首次执行其实是 14:10，不是 14:12。
实操建议：
- 需要严格按某个偏移量执行（比如每小时的 17 分启动），必须手动填 cron 表达式，例如
17 * * * * - 想实现“每 5 分钟且首次延迟 2 秒”，宝塔做不到——得在脚本里用
sleep 2控制，但注意这会占用 cron 进程，别在耗时任务里滥用 - 测试频率时，把时间改成
* * * * *（每分钟），确认能跑通后再换回真实周期
Python 脚本里读不到环境变量或 pip 包？别依赖全局 Python
宝塔新建的站点 Python 项目往往用虚拟环境，而定时任务默认走系统 python，既找不到 venv 里的包，也读不到 .env 文件或项目根目录下的配置。
实操建议：
- 命令栏里不要只写
python script.py，改用/www/wwwroot/myapp/venv/bin/python /www/wwwroot/myapp/script.py - 如果脚本依赖
os.getenv()，在 shell 脚本里显式导出：export ENV=production && /path/to/venv/bin/python script.py - 避免用
pip install --user，宝塔任务不认~/.local，所有依赖必须装进 venv 或系统 Python（不推荐后者）
任务执行超时被强制 kill？不是宝塔的锅，是 Linux cron 的默认限制
宝塔本身不限制执行时长，但底层 cron 启动的进程受 systemd 或系统级 timeout 约束（尤其 CentOS 7+）。常见现象是：脚本卡在数据库查询或 HTTP 请求，跑满 10 分钟后静默退出，日志里连错误都没留。
实操建议：
- 在命令前加超时控制：
timeout 300 /path/to/script.sh（单位秒），让它主动失败，好排查 - 长期任务（如数据同步）务必在脚本内做断点续传或状态标记，别指望“一次跑完”
- 检查
/etc/systemd/system/multi-user.target.wants/crond.service里有没有RuntimeMaxSec=600类配置，有就注释掉并systemctl daemon-reload
真正麻烦的从来不是怎么填那个“周期”下拉框，而是脚本在无人值守、无交互、无完整环境的 cron 上能不能稳住——每次加新任务，都该当成部署一个微型服务来验。
