Laravel开发环境中计划任务命令未执行问题排查

你遇到的问题核心是Laravel的任务调度器本身不会自动运行，必须依赖系统Cron服务每分钟触发一次调度命令，以下是几个最可能的遗漏点：

• 未配置系统级Cron定时任务
  这是最常见的原因。Laravel的调度器需要系统Cron每分钟执行一次php artisan schedule:run，才能检查并运行到期的任务。
  操作步骤：

  1. 执行crontab -e打开当前用户的Cron配置
  2. 添加以下内容（替换项目的绝对路径）：

     * * * * * cd /你的项目绝对路径 && php artisan schedule:run >> /dev/null 2>&1
     

  3. 保存退出，Cron会自动加载新配置
     注意：如果服务器上有多个PHP版本，要使用项目依赖的PHP绝对路径，比如/usr/local/php8.2/bin/php

• 权限不匹配
  Cron默认以当前用户身份执行，如果该用户没有项目目录的读写权限，或者无法执行PHP命令，任务就会失败。

  • 可以在Cron命令前指定用户（比如用www-data）：

    * * * * * www-data cd /你的项目绝对路径 && php artisan schedule:run >> /dev/null 2>&1
    

  • 或者调整项目目录权限：

    chown -R www-data:www-data /你的项目绝对路径
    

• 环境变量缺失
  Cron的执行环境和终端环境不一致，可能缺少Laravel运行必需的环境变量（比如APP_ENV、APP_KEY）。

  • 可以在调度命令里指定运行环境：

    protected function schedule(Schedule $schedule)
    {
        $schedule->command('process:pending-reports')
            ->everyFifteenMinutes()
            ->environment('production'); // 根据你的环境调整
    }
    

  • 或者在Cron行里直接指定环境变量：

    * * * * * APP_ENV=production cd /你的项目绝对路径 && php artisan schedule:run >> /dev/null 2>&1
    

• 未查看执行日志
  看不到任务执行情况的话，很难定位问题。可以给任务添加日志输出：

  protected function schedule(Schedule $schedule)
  {
      $schedule->command('process:pending-reports')
          ->everyFifteenMinutes()
          ->appendOutputTo(storage_path('logs/pending-reports.log'));
  }
  

  也可以查看系统Cron日志，比如Ubuntu的/var/log/syslog，CentOS的/var/log/cron，里面会记录Cron任务的执行状态。

内容的提问来源于stack exchange，提问作者Sagar Thatte