Laravel队列自动终止求助：单任务完成后停止处理后续任务

我有一个Laravel队列任务，执行约10-12秒后会成功完成，既不失败也不生成错误日志。但问题是，这个任务完成后，队列就会停止处理后续任务，必须重新运行queue:work命令才能继续执行任务。

我已经尝试过以下操作，但都没有效果：

• 在任务类中添加以下配置，并设置了尽可能大的值（最大到10000）：

public $timeout = ...;
public $retry = ...;

public function retryUntil()
{
    return now()->addSeconds(...);
}

• 在运行queue:work时添加--memory、--timeout、--retry等命令行参数

另外，我的php.ini配置已经足够高：

memory_limit = 1024M
post_max_size = 16M
upload_max_filesize = 16M
max_input_vars = 3000
max_execution_time = 600

排查方向与解决方案 #

1. 排查内存泄漏导致进程终止 #

尽管已设置--memory参数，隐性内存泄漏仍可能导致进程触发Laravel的内存阈值自动终止。可以：

• 调高内存限制并运行：php artisan queue:work --memory=2048 --timeout=60
• 在任务中添加内存监控日志，对比任务前后内存变化：

public function handle()
{
    Log::info('任务启动内存占用: ' . memory_get_usage(true));
    // 任务逻辑代码
    Log::info('任务结束内存占用: ' . memory_get_usage(true));
}

2. 检查队列驱动连接稳定性 #

若使用Redis或数据库驱动，连接中断可能导致进程无法继续处理任务：

• Redis驱动：在config/queue.php中调整Redis连接的read_write_timeout参数，同时检查Redis服务是否稳定。
• 数据库驱动：检查数据库的wait_timeout设置，避免因连接超时导致进程失连。

3. 捕获隐性致命错误 #

任务内部可能存在未被日志记录的致命错误，可通过注册 shutdown 函数捕获：

public function handle()
{
    register_shutdown_function(function () {
        $error = error_get_last();
        if ($error) {
            Log::error('任务终止错误信息: ' . print_r($error, true));
        }
    });
    // 任务逻辑代码
}

4. 启用详细队列日志追踪 #

运行队列时输出详细日志到文件，定位进程停止前的异常：

php artisan queue:work --verbose --timeout=60 --memory=2048 > queue.log 2>&1

查看queue.log文件，分析进程停止前的最后日志内容。

5. 尝试queue:listen替代queue:work #

queue:listen会为每个任务重新启动PHP进程，若切换后问题消失，说明是queue:work守护进程模式下的进程异常问题。

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