Laravel定时任务（Cron Job）异常求助：手动正常，服务器Cron不生效

我之前也遇到过一模一样的问题——手动跑php artisan schedule:run完全正常，但配置Cron后就是没反应，多半是环境或权限相关的问题，给你整理几个最有效的排查和解决方向：

1. 检查PHP的绝对路径 #

Cron的环境变量和你终端用的不一样，默认的php可能不是你项目使用的PHP版本。先在终端执行：

which php

拿到类似/usr/local/bin/php或者/usr/bin/php的绝对路径，然后把Cron命令里的php替换成这个路径，比如：

* * * * * /usr/local/bin/php /laravel项目目录/artisan schedule:run >> /var/log/laravel-schedule.log 2>&1

2. 修复权限问题 #

Cron默认用当前用户执行，可能和你手动执行的用户（比如你的登录用户）不同，导致没有项目文件的读写权限：

• 可以指定Cron用Web服务器的用户执行（比如Nginx的www-data）：

  * * * * * sudo -u www-data /usr/local/bin/php /laravel项目目录/artisan schedule:run >> /var/log/laravel-schedule.log 2>&1
  

• 确保项目的storage和bootstrap/cache目录有足够的读写权限，比如：

  chmod -R 775 storage bootstrap/cache
  chown -R www-data:www-data storage bootstrap/cache
  

3. 加载环境变量 #

Laravel依赖.env文件的配置，但Cron不会自动加载用户的环境变量，导致数据库连接、配置读取失败：

• 在Cron命令里先切换到项目目录，再执行命令：

  * * * * * cd /laravel项目目录 && /usr/local/bin/php artisan schedule:run --env=production >> /var/log/laravel-schedule.log 2>&1
  

• 如果还是不行，可以在Cron任务开头加载用户的环境配置文件：

  * * * * * source ~/.bashrc && cd /laravel项目目录 && /usr/local/bin/php artisan schedule:run >> /var/log/laravel-schedule.log 2>&1
  

4. 先不要丢弃日志！ #

你之前把输出重定向到/dev/null，完全看不到错误信息，这是排查的大忌！先把日志输出到一个文件，比如上面示例的/var/log/laravel-schedule.log，然后查看日志内容：

cat /var/log/laravel-schedule.log

日志里会明确告诉你问题所在——比如找不到Controller类、数据库连接失败、权限不足等。

5. 建议：把Controller逻辑改成Artisan命令 #

虽然Laravel允许直接调度Controller方法，但这种方式不利于调试和维护。更规范的做法是：

1. 创建一个Artisan命令：php artisan make:command SyncSale
2. 把SaleController@sync里的逻辑移到命令的handle()方法中
3. 在Kernel的$commands数组里注册这个命令：

   protected $commands = [
       \App\Console\Commands\SyncSale::class,
   ];
   

4. 调度这个命令：

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

这样单独执行php artisan sale:sync就能测试逻辑，Cron调度也更稳定。

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