登录
首页 >  文章 >  php教程

宝塔计划任务不执行?检查Crontab与脚本路径

时间:2026-04-26 20:18:54 451浏览 收藏

宝塔计划任务不执行,绝大多数并非面板故障或设置错误,而是底层crond服务未运行、脚本在crond独立环境中因路径错误、权限缺失、解释器未显式指定、PAM认证失败(如root密码过期)、系统时区错配或环境变量缺失等根本原因导致“静默失效”——本文直击90%以上真实痛点,手把手教你通过检查systemctl状态、强制使用绝对路径与执行权限、排查/var/log/cron和/www/wwwlogs/cron.log双日志、重置认证上下文及校准系统时区,快速定位并彻底解决任务“看似设置了却从不执行”的顽疾。

宝塔面板计划任务不执行怎么修复_检查Crontab服务状态与脚本路径

宝塔计划任务不执行,90% 以上是 crond 服务没跑起来,或脚本在 crond 环境下根本找不到、跑不动。不是面板坏了,也不是你设置错了,而是底层 Linux 的定时调度引擎压根没工作,或者它“看不见”你的脚本。

crond 服务是否真的在运行

宝塔的计划任务只是个前端界面,真正干活的是系统级的 crond 进程。它一旦停止,所有任务都会静默失效,面板上连报错都不会有。

  • systemctl status crond 查状态,看到 active (running) 才算正常;若显示 inactive (dead)not found,说明服务根本没启。
  • CentOS/RHEL 8+ 或某些新版系统可能用 cronie 包,服务名是 crond;Debian/Ubuntu 则常用 cron 服务名,得试 systemctl status cron
  • 启动后别忘了加自启:systemctl enable crond(或 cron),否则重启服务器就又挂了。

脚本路径和执行权限是否正确

宝塔里填的“脚本内容”,在 crond 环境下是以独立 shell 启动的,没有当前工作目录、没有用户登录时的 $PATH、也不会自动 source ~/.bashrc —— 所以相对路径、缺解释器、没权限,全都会失败且不报错。

  • 必须用绝对路径,比如 /www/wwwroot/site.com/backup.sh,不能写 ./backup.shbackup.sh
  • Shell 脚本要加执行权限:chmod +x /www/wwwroot/site.com/backup.sh
  • PHP 脚本推荐显式调用解释器:/usr/bin/php /www/wwwroot/site.com/cron.php,别只写 php cron.php(crond 环境里很可能找不到 php 命令)。
  • 如果脚本依赖环境变量(如 HOMEPATH),得在脚本开头手动设置,或用 /bin/bash -c 'export PATH=...; /path/to/script.sh' 包一层。

crond 日志里有没有 PAM 认证失败

当你发现 crond 明明 running,但任务就是不触发,且日志里反复出现 PAM ERRORAuthentication token is no longer valid,大概率是 root 密码过期了 —— 这在 CentOS/RHEL 类系统上很常见,尤其启用了密码策略后。

  • 查日志:tail -f /var/log/cron,重点看有没有含 PAMexpired password 的行。
  • 确认 root 密码状态:chage -l root,若看到 Password expires : [date] 且已过期,就得重设。
  • 重置密码:passwd,输两遍新密码;想一劳永逸可设永不过期:chage -M 99999 root
  • 改完密码后,必须重启 crondsystemctl restart crond,否则旧认证上下文还在缓存里。

宝塔自身 cron.log 是否有线索

宝塔会把任务启动/结束记录到自己的日志里,路径是 /www/wwwlogs/cron.log。它不反映底层失败原因,但能帮你确认:任务到底有没有被面板触发?有没有卡在“开始执行”就没了?

  • 执行 tail -f /www/wwwlogs/cron.log,然后在面板里手动点击“执行”一次,看日志是否新增一行“开始执行”。没有,说明面板层就断了(比如任务被禁用、面板进程异常)。
  • 如果有“开始执行”但没“执行结束”,大概率是脚本卡死、超时或被 kill;如果有“执行结束”但结果不对,问题就在脚本逻辑或环境里。
  • 注意:这个日志不会显示 stderr 输出,所以脚本里的 echovar_dump 默认看不到,得重定向到文件,比如 /usr/bin/php /path/to/script.php >> /tmp/cron_debug.log 2>&1

最常被忽略的一点:crond 不认面板里显示的“北京时间”,它只认系统 localtime。哪怕宝塔右上角时间是对的,只要 /etc/localtime 指向错误时区,任务就会错峰执行甚至完全跳过。修时区比修脚本还容易漏掉。

好了,本文到此结束,带大家了解了《宝塔计划任务不执行?检查Crontab与脚本路径》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>