Laravel Redis队列事件偶发未调度问题求助

问题背景 #

在Laravel中定义了Redis队列执行的事件，测试环境运行完全正常，但生产环境偶发事件未调度，且未调度的事件在Worker日志中无任何记录。

相关代码如下：

事件调度代码 #

event(new AfterPaymentSuccessEvent($payment->order_id));

监听器代码 #

class OperationOrder implements ShouldQueue
{
    public $connection = 'redis';
    public $queue = 'medium';
    
    public function handle(AfterPaymentSuccessEvent $event)
    {
        $order = Order::where('id', $event->order)->first();
        $order->update([
            'status' => OrderStatusEnum::Completed
        ]);
    }
}

事件类代码 #

class AfterPaymentSuccessEvent
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    public string $order;
    public function __construct($order)
    {
        $this->order = $order;
    }
    public function broadcastOn()
    {
        return new PrivateChannel('channel-name');
    }
}

队列启动命令 #

php queue:work  --sleep=3 --tries=3 --max-time=3600 --queue=high,medium,low

EventServiceProvider配置 #

protected $listen = [
    AfterPaymentSuccessEvent::class => [
        OperationOrder::class
    ]
];

排查方向 #

• 事务提交时机问题：如果事件调度在数据库事务内部执行，事务未提交就触发事件可能导致任务读取未提交数据，甚至事务回滚时任务被丢弃。可以改用Event::dispatchAfterCommit(new AfterPaymentSuccessEvent($payment->order_id))，确保事务提交后再调度事件。
• Redis连接异常：生产环境Redis可能偶发连接超时、断开，导致事件无法写入队列。检查storage/logs下的Laravel日志，看是否有Redis连接、写入失败的错误记录，可调整Redis超时参数或增加连接重试机制。
• 队列进程状态异常：queue:work进程可能意外退出或被OOM Killer杀掉。用Supervisor等工具监控进程状态，同时查看服务器系统日志，确认是否有进程被终止的记录。
• 事件序列化问题：事件类$order定义为string，但传入的$payment->order_id可能是整数，序列化/反序列化时可能出现偶发类型问题。可将$order类型改为int，或在构造函数中强制转换：$this->order = (string)$order;。
• 队列负载与优先级问题：high队列任务量过大可能阻塞medium队列。用redis-cli LLEN laravel:queue:medium查看队列长度，若有堆积可增加队列进程数或调整优先级策略。
• 队列配置一致性问题：检查生产环境.env文件，确保QUEUE_CONNECTION=redis，且Redis连接参数（主机、端口、密码等）配置正确，同时确认queue:work启动时的连接与监听器定义的$connection='redis'一致。

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