如何排查宝塔面板安装后计划任务不执行_检查crond服务状态并手动测试脚本路径-php教程-PHP中文网

crond服务未运行导致宝塔定时任务全部失效；脚本在crond简陋环境中因路径、环境变量、权限等问题执行失败；需检查系统crond状态、使用绝对路径、显式指定解释器、绕过防火墙或改用PHP CLI执行。

如何排查宝塔面板安装后计划任务不执行_检查crond服务状态并手动测试脚本路径

crond 服务没起来，计划任务根本不会触发

宝塔面板依赖系统级 crond 服务来驱动所有定时任务，哪怕你在面板里添加了 10 条任务，只要 crond 没运行，就全等于没写。常见现象是：面板里任务状态显示“已启用”，但日志始终为空、脚本从不被执行。

检查方式很简单：

systemctl status crond

如果看到 active: inactive (dead) 或报错 Unit crond.service not found（CentOS 8+/AlmaLinux 等使用 crondie 的系统），就得先装或启服务：

CentOS 7 / Debian 9-10 / Ubuntu 16-20：systemctl start crond && systemctl enable crond
CentOS 8+ / Rocky/AlmaLinux：dnf install cronie && systemctl enable --now crond
Debian 11+ / Ubuntu 22+：apt install cron && systemctl enable --now cron

注意：重启 crond 后，宝塔面板本身不需要重启，但已有任务可能要等下一个周期才生效（或手动点击“立即执行”测试）。

宝塔里写的脚本路径在 crond 环境下根本找不到

这是最隐蔽也最常踩的坑：你在宝塔界面填的脚本路径（比如 /www/wwwroot/test.sh），在面板 Web 界面能点“立即执行”成功，但到真正由 crond 调用时却失败——因为 crond 默认以 root 用户运行，且环境变量极简（$PATH 不含 /usr/local/bin 等），更关键的是：它不读取你的 shell 配置文件（~/.bashrc、/etc/profile）。

排查方法：

进宝塔「计划任务」→ 找到对应任务 → 点「日志」，看是否报 command not found 或 No such file or directory
手动模拟 crond 环境执行一次：
```
sudo -u root /bin/bash -c 'echo $PATH; /www/wwwroot/test.sh'
```
，观察输出是否和面板日志一致

修复建议：

脚本第一行必须写明解释器：#!/bin/bash（别用 #!/usr/bin/env bash，env 可能不在 crond 的 PATH 里）
脚本内所有命令尽量用绝对路径，比如 /usr/bin/php 而非 php，/bin/curl 而非 curl
如果脚本依赖当前目录（如读取同级配置文件），开头加 cd /www/wwwroot 显式切换

宝塔任务日志为空，但 crond 实际执行了错误命令

不是所有失败都会被宝塔捕获并写入日志。例如：脚本有语法错误、权限不足（Permission denied）、或执行超时被系统 kill，都可能导致日志空白或只显示“执行成功”（因宝塔只判断进程退出码是否为 0，而某些错误不改变退出码）。

可靠验证方式是绕过宝塔，直接查系统级 crond 日志：

确认 /var/log/cron 是否开启：grep "cron.*on" /etc/rsyslog.conf，若无输出，需在该文件末尾加 cron.* /var/log/cron 并 systemctl restart rsyslog
实时监听执行记录：
```
tail -f /var/log/cron | grep CRON
```
，然后等任务触发，看有没有类似 (root) CMD (/www/wwwroot/test.sh) 的条目
如果看到 CMD 行但脚本没效果，说明问题出在脚本内部逻辑或权限上，不是调度层问题

PHP 脚本通过 wget/curl 触发时被宝塔防火墙拦截

不少用户习惯用 wget -qO- http://127.0.0.1/api.php 方式触发 PHP 接口，这看似方便，但在宝塔环境下极易失败——因为宝塔默认启用「网站防火墙」或「安全入口」，会拒绝来自本地（127.0.0.1）的未带 User-Agent 或无 Referer 的请求，导致返回 403 或空响应。

验证方法：

手动执行该 wget 命令，加 -S 参数看响应头：
```
wget -S -qO- http://127.0.0.1/api.php
```
若返回 HTTP/1.1 403 Forbidden 或 X-Powered-By: none，基本就是防火墙挡了

临时绕过方案（仅用于验证）：

给 wget 加伪装头：wget -qO- --user-agent="Mozilla/5.0" http://127.0.0.1/api.php
改用 curl 并带上完整头：curl -s -H "User-Agent: Mozilla/5.0" http://127.0.0.1/api.php

长期建议：这类任务应直接调用 CLI 模式 PHP，避免走 HTTP 层，例如：/usr/bin/php /www/wwwroot/api.php —— 这样既跳过防火墙，又省去网络开销，还更容易调试。

真正卡住人的往往不是 crond 开没开，而是脚本在那个干净得过分的 crond 环境里，连 date 命令都要写成 /bin/date 才认得。每次改完记得清宝塔缓存（右上角齿轮→「清除缓存」），不然它可能还在用旧的 crontab 内容。