Laravel自定义Artisan命令需optimize:clear才能运行问题排查

1. 缓存一致性问题 #

你依赖optimize:clear才能维持运行，说明Laravel的优化缓存（类加载映射、配置缓存等）和实际代码/配置出现了不一致。之前运行正常，近期出现问题，大概率是有代码或配置变更后，没有更新对应的优化缓存，导致队列worker加载了旧的、错误的代码逻辑，引发隐性崩溃——因为进程崩溃时没有被捕获，所以既没有end日志，也没有错误日志。

2. 队列Worker启动方式错误 #

每分钟启动队列worker的操作完全不合理：Laravel队列worker是常驻进程，频繁启动会导致大量进程堆积，消耗服务器内存、数据库连接等资源，最终进程被操作系统强制杀死（比如OOM Killer），任务中途终止，无法输出结束日志。

3. 未捕获的隐性异常 #

任务逻辑中可能存在未被捕获的异常（比如数据库死锁、资源超时、方法调用错误），这些异常直接导致worker进程崩溃，但因为没有全局异常捕获，无法记录错误日志。

一、彻底解决缓存问题 #

1. 立即停止每分钟执行optimize:clear的调度任务，频繁清理缓存会严重影响性能，且只是临时 workaround。
2. 手动清除所有Laravel缓存：

   php artisan optimize:clear
   

   这会一次性清除配置、路由、视图、类加载映射等所有缓存。
3. 若确实需要代码优化（生产环境可选），在代码部署完成后手动执行：

   php artisan optimize
   

   后续每次代码或配置变更后，都要重新执行上述命令更新缓存。

二、修复队列Worker的运行方式 #

1. 移除调度中「每分钟启动队列worker」的配置，改用进程管理器（如Supervisor）管理常驻worker进程，这是Laravel队列的标准生产环境部署方式。
2. Supervisor配置示例（保存为/etc/supervisor/conf.d/laravel-queue.conf）：

   [program:laravel-queue]
   process_name=%(program_name)s_%(process_num)02d
   command=php /你的项目绝对路径/artisan queue:work --sleep=3 --tries=3 --max-time=3600
   autostart=true
   autorestart=true
   user=www-data # 替换为你的服务器运行用户
   numprocs=4 # 根据服务器配置调整进程数
   redirect_stderr=true
   stdout_logfile=/你的项目绝对路径/storage/logs/queue-worker.log
   

3. 启动并启用Supervisor：

   sudo supervisorctl reread
   sudo supervisorctl update
   sudo supervisorctl start laravel-queue:*
   

   这样worker会持续运行，异常崩溃时自动重启，不会出现进程堆积。

三、捕获隐性异常，排查任务逻辑 #

1. 在MiningRunJob的handle方法中添加全局异常捕获，强制记录错误日志：

   use Illuminate\Support\Facades\Log;
   
   public function handle()
   {
       try {
           Log::info('MiningRunJob start');
           // 你的算法逻辑代码
           // ...
           Log::info('MiningRunJob end');
       } catch (\Throwable $e) {
           Log::error('MiningRunJob 执行失败', [
               '错误信息' => $e->getMessage(),
               '调用栈' => $e->getTraceAsString()
           ]);
           throw $e; // 保留抛出异常，让队列标记任务失败（如需重试）
       }
   }
   

2. 检查服务器系统日志（如/var/log/syslog或/var/log/messages），查看是否有OOM Killer杀死进程的记录，若有则需要调整服务器内存配置或减少worker进程数。
3. 检查数据库连接配置，确保config/database.php中的timeout、max_connections等参数合理，避免任务执行时出现连接耗尽或超时。

内容的提问来源于stack exchange，提问作者Влад Рогов