Laravel定时任务异常求助：schedule:run命令未正常执行

核心问题分析 #

你看到的Artisan命令帮助输出，说明Cron执行的php public_html/laravel/artisan schedule:run命令未被正确解析，大概率是路径错误、PHP环境不一致或命令格式问题导致的。

具体排查步骤 #

1. 强制使用绝对路径 #

Cron执行环境无当前目录上下文，必须用绝对路径指向Artisan文件：

• 通过SSH登录服务器，执行pwd获取Laravel项目根目录（例如/home/your-user/public_html/laravel）
• 修正Cron命令为绝对路径格式：

  /usr/bin/php /home/your-user/public_html/laravel/artisan schedule:run >> /dev/null 2>&1
  

  注意：/usr/bin/php需替换为服务器实际的PHP CLI路径（可通过which php命令获取）

2. 对齐PHP CLI与Web环境版本 #

Web环境的PHP版本（输出显示PHP/8.1.18）可能和Cron使用的PHP CLI版本不一致，导致Artisan无法正常运行：

• 执行php -v查看CLI版本，对比Web环境版本
• 若版本不符，在Cron命令中指定正确的PHP CLI路径，例如：

  /usr/bin/php8.1 /home/your-user/public_html/laravel/artisan schedule:run >> /dev/null 2>&1
  

3. 终端直接测试命令可行性 #

在SSH终端中执行完整的Cron命令，验证是否能正常运行：

/usr/bin/php /home/your-user/public_html/laravel/artisan schedule:run

• 若终端执行正常但Cron失败，说明Cron环境变量缺失，需在Cron任务开头添加环境变量配置：

  PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
  * * * * * /usr/bin/php /home/your-user/public_html/laravel/artisan schedule:run >> /dev/null 2>&1
  

4. 检查Laravel调度任务定义 #

确认app/Console/Kernel.php中的调度任务配置正确：

protected function schedule(Schedule $schedule)
{
    $schedule->command('your:custom-command')->everyMinute();
}

确保自定义命令已通过php artisan make:command创建（Laravel 5.5+自动发现，无需手动注册）。

5. 查看Cron日志定位错误 #

服务器Cron日志通常位于/var/log/cron或/var/log/syslog，查看日志获取详细错误信息：

tail -f /var/log/cron

额外注意事项 #

• Cron执行时不会加载Web服务器环境变量，若Laravel依赖特定环境变量，需在Cron命令前显式设置：

  * * * * * APP_ENV=production /usr/bin/php /home/your-user/public_html/laravel/artisan schedule:run >> /dev/null 2>&1
  

• 所有文件和命令均使用绝对路径，避免相对路径导致的解析错误。

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