EC2中已配置的Laravel调度器未运行的问题排查求助

AI 小北

2026-4-8

我之前在EC2上部署Laravel调度器时也踩过类似的坑，太懂这种明明配置了却没反应的憋屈感了！给你梳理几个必查的方向，你可以一步步排查：

先确认Crontab的核心驱动任务是否配置正确：Laravel的调度器本身不会自动运行，必须依赖一个每分钟执行一次的Cron任务来触发所有自定义调度。你得检查EC2上对应用户（比如项目运行用的www-data或者root）的crontab里有没有这条命令：
```
* * * * * cd /你的项目根目录绝对路径 && php artisan schedule:run >> /dev/null 2>&1
```
可以通过crontab -e（当前用户）或者crontab -u 目标用户名 -e来查看/编辑，注意两点：一是项目路径必须是绝对路径，二是如果服务器有多个PHP版本，最好用绝对路径（比如/usr/bin/php）代替php，避免找不到正确的PHP环境。
检查Cron服务是否正常运行：如果Cron服务本身没启动，那一切都是白搭。在EC2的终端里执行systemctl status cron（Ubuntu/Debian系）或者systemctl status crond（CentOS/RHEL系），看服务状态是不是active(running)。如果没运行，就用systemctl start cron启动，再加systemctl enable cron设置开机自启。
手动测试调度命令，排查代码/权限问题：直接在终端里切换到项目根目录，执行php artisan schedule:run，看看有没有报错，同时观察日志是否生成。如果手动执行都没日志或者报错，那大概率是：
- 项目目录/日志文件的权限问题：Cron运行的用户有没有读写项目目录、日志文件的权限？比如如果Cron用root运行，但项目文件归www-data所有，就会出现权限不足的问题。
- 调度任务代码本身有静默异常：比如任务里的代码抛出了异常但没被捕获，导致任务直接终止却没日志。可以给任务加上try-catch块，把异常也记录到日志里：
```
->everySixHours()->run(function () {
    try {
        // 你的任务代码
        logger('调度任务执行成功');
    } catch (\Exception $e) {
        logger('调度任务失败：'.$e->getMessage());
    }
});
```
检查时区是否一致：Laravel配置文件config/app.php里的timezone设置，要和EC2服务器的时区保持一致。可以用终端命令date查看服务器时区，对比Laravel的时区配置——时区不一致会导致任务执行时间和你预期的完全对不上，看起来就是“没运行”。
查看Cron自身的日志：很多时候Cron执行任务时的错误不会直接输出到终端，而是写到系统日志里。Ubuntu可以查看/var/log/syslog，用grep CRON /var/log/syslog过滤出Cron相关的记录，看看有没有执行schedule:run的记录，或者有没有报错（比如路径不存在、PHP命令找不到等）。
检查是否处于维护模式：如果Laravel开启了维护模式（执行过php artisan down），默认情况下调度任务是不会运行的，除非你在任务里加上->evenInMaintenanceMode()。可以执行php artisan up退出维护模式试试。

内容来源于stack exchange