罗罗编程学习记录
本页内容 展开查看

06.5.4.8 事件监听与广播

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.4 Laravel

覆盖范围

  • 事件与监听器注册、订阅者与模型事件
  • ShouldBroadcast、频道类型与私有授权
  • 队列化广播、驱动差异与事务注意事项

基础事件注册概念见 06.5.1.1 框架架构与生命周期;本页聚焦事件与广播机制纵深。

06.5.4.8-001 事件类与监听器如何通过 Event::listen 注册?

一句话结论

Event::listen(事件类或名称, 监听器类/闭包) 把事件与处理逻辑登记到事件分发器;事件分发时按注册顺序调用匹配的监听器,监听器可由容器解析注入依赖。

概念解释

事件类携带数据,监听器负责响应。注册通常在服务提供者 boot 阶段完成;监听器类的 handle 方法接收事件实例,构造依赖由容器注入。

原理流程

  1. 定义事件类,公开属性承载数据。
  2. 提供者中 listen(Event::class, Listener::class) 登记映射。
  3. 事件分发时分发器遍历匹配监听器。
  4. 容器解析监听器并调用 handle。

代码或图示

// 事件
class OrderCreated
{
    public function __construct(public readonly Order $order) {}
}

// 注册
Event::listen(OrderCreated::class, SendOrderNotification::class);

// 监听器
class SendOrderNotification
{
    public function handle(OrderCreated $event): void { /* ... */ }
}

常见误区

  • 监听器 handle 形参类型与事件类不匹配:分发时类型提示无法赋值,方法不被正确调用。
  • 在 register 阶段注册监听:虽可执行,但其他提供者监听尚未齐备,放 boot 更稳妥。

追问

  • 一个事件能挂多个监听器吗?答:可以,按注册顺序依次调用;监听器间无直接返回值传递。
  • 闭包监听器与类监听器如何选?答:简单逻辑用闭包;有依赖注入、队列化、复用需求用类监听器。

06.5.4.8-002 事件自动发现与订阅者(subscribe)两种注册方式有什么区别?

一句话结论

自动发现按命名约定把事件类映射到同名监听器,无需手写映射;订阅者在一个类内定义 subscribe 方法,绑定多个事件到多个处理方法,集中管理一组相关监听。

概念解释

  • 自动发现:框架按监听器类名推断对应事件,需遵循命名约定(具体约定以当前版本文档为准)。
  • 订阅者:实现订阅接口,subscribe(Dispatcher $events) 内用 $events->listen 配置方法映射。

原理流程

  1. 自动发现:生成/扫描监听类,按约定解析事件映射并缓存。
  2. 订阅者:类实现订阅契约,subscribe 方法登记事件 → 方法名。
  3. 分发器按两种来源合并监听器清单。
  4. 事件触发时调用对应处理方法。

代码或图示

class EventSubscriber implements Subscriber
{
    public function subscribe(Dispatcher $events): array
    {
        return [
            OrderCreated::class => 'onCreated',
            OrderUpdated::class => 'onUpdated',
        ];
    }

    public function onCreated(OrderCreated $event): void { /* ... */ }
}

常见误区

  • 订阅者方法名与映射不一致:事件触发时找不到处理方法。
  • 自动发现依赖类名约定却随意命名:映射失败,事件无监听器响应。

追问

  • 订阅者注册到哪里?答:在事件配置/提供者中登记订阅者类,分发器调用其 subscribe 完成绑定。
  • 自动发现缓存何时刷新?答:监听清单编译进启动缓存,新增/改名监听器后需刷新事件缓存。

06.5.4.8-003 dispatch / event 分发事件的内部流程是什么?

一句话结论

分发事件时,分发器按事件名/类名匹配监听器清单,逐个解析监听器并调用处理方法;队列化监听器转入队列执行,同步监听器在当前请求内执行完毕后返回。

概念解释

event() 助手与 Event::dispatch 等价入口。分发流程区分监听器是否队列化:同步直接调用,队列化推入队列后异步处理。事件数据随事件实例传递。

原理流程

  1. 调用 event(new OrderCreated($order))。
  2. 分发器按类名/名称匹配监听器数组。
  3. 同步监听器:容器解析并调用 handle。
  4. 队列监听器:封装为任务入队;分发结束返回。

代码或图示

event(new OrderCreated($order));

// 等价入口
Event::dispatch(new OrderCreated($order));

常见误区

  • 以为事件分发是异步的:默认监听器同步执行,异步需实现队列化接口或标记队列属性。
  • 事件构造函数注入服务实例:事件对象可能被序列化入队/广播,只应携带可序列化数据。

追问

  • 监听器执行顺序如何保证?答:按注册顺序调用;强顺序依赖应在同一监听器内编排,不依赖跨监听器先后。
  • 分发后如何获知执行结果?答:同步监听器可通过事件对象回写属性;队列化监听器无即时返回值。

06.5.4.8-004 模型事件钩子 created/updated/saved/deleting 等触发时机是什么?

一句话结论

模型在持久化前后触发对应钩子:saving/saved 覆盖创建与更新,creating/created 针对新增,updating/updated 针对更新,deleting/deleted 针对删除;删除前可阻止操作。

概念解释

钩子挂在模型生命周期节点:保存前(saving/creating/updating)可校验或修改,保存后(saved/created/updated)做副作用通知,删除前(deleting)可取消删除,删除后(deleted)清理关联。

原理流程

  1. 调用 save/create/update/delete。
  2. 保存前触发 before 钩子(saving → creating/updating)。
  3. 执行数据库写入。
  4. 写入后触发 after 钩子(saved → created/updated);删除流程对应 deleting/deleted。

代码或图示

protected static function booted(): void
{
    static::creating(function (Post $post) {
        $post->slug = Str::slug($post->title);
    });

    static::deleted(function (Post $post) {
        $post->comments()->delete();
    });
}

常见误区

  • 在 after 钩子阻止删除:deleting 才是删除前钩子,deleted 时记录已删除。
  • 钩子内再次 save 同一模型:递归触发事件,需用无事件保存或标志位避免循环。

追问

  • 模型事件与观察者关系?答:观察者是钩子的独立类形式,方法名对应事件名;闭包钩子写在 booted 内,二者机制相同。
  • 批量 insert 触发模型事件吗?答:查询构造器批量插入不经过模型生命周期,不触发钩子。

06.5.4.8-005 观察者 Observer 与闭包监听器如何选择?

一句话结论

单个模型的多个生命周期行为用观察者类集中管理;跨模型、与特定业务事件耦合的响应使用独立事件监听器;闭包钩子适合简单临时逻辑,复杂行为抽类。

概念解释

观察者绑定模型事件,方法名即事件名;事件监听器响应自定义业务事件。闭包钩子写在模型 booted 内,逻辑复杂会膨胀模型类。

原理流程

  1. 判断行为属于模型生命周期还是业务事件。
  2. 模型生命周期:注册观察者或闭包钩子。
  3. 业务领域事件:定义事件类并挂监听器/订阅者。
  4. 复杂依赖与队列化需求使用类形式。

代码或图示

// 观察者注册(位置与 API 以当前版本为准)
Post::observe(PostObserver::class);

class PostObserver
{
    public function created(Post $post): void { /* ... */ }
    public function deleted(Post $post): void { /* ... */ }
}

常见误区

  • 把跨模块业务通知写进模型观察者:模型与外部业务耦合,模块边界模糊。
  • 观察者方法未声明事件类型提示:容器解析时无法确定事件实例。

追问

  • 观察者支持队列化吗?答:观察者方法对应的事件处理可按队列监听器方式配置;具体支持粒度以版本源码为准。
  • 多个观察者监听同一模型事件如何执行?答:按注册顺序调用,与多监听器规则一致。

06.5.4.8-006 ShouldBroadcast 接口如何把事件推到广播通道?

一句话结论

事件类实现 ShouldBroadcast 契约后,分发时框架把事件序列化推送到广播驱动器,按 broadcastOn() 指定的频道发布;前端订阅对应频道接收消息。

概念解释

广播事件是“推送到前端”的特殊事件。接口标记事件需广播,频道、载荷、命名在事件类方法/属性中定义。广播默认走队列异步发送(ShouldBroadcastNow 除外)。

原理流程

  1. 事件类实现 ShouldBroadcast。
  2. 定义 broadcastOn() 返回频道数组,broadcastWith() 定义载荷。
  3. 事件分发时框架序列化并推入广播队列。
  4. 广播驱动向指定频道推送,前端订阅接收。

代码或图示

class ReportGenerated implements ShouldBroadcast
{
    public function __construct(public readonly Report $report) {}

    public function broadcastOn(): Channel
    {
        return new PrivateChannel('reports.' . $this->report->user_id);
    }

    public function broadcastWith(): array
    {
        return ['id' => $this->report->id, 'title' => $this->report->title];
    }
}

常见误区

  • 事件携带不可序列化资源(容器、连接):广播序列化失败,载荷只放标量/数组/模型 ID。
  • 私有频道未做授权:前端订阅被拒绝,消息收不到。

追问

  • 广播事件还会执行普通监听器吗?答:实现广播接口不影响事件监听注册;同一事件可同时有监听器与广播推送。
  • 广播在什么队列执行?答:默认使用队列系统异步广播;连接/队列名可在事件属性中指定,见后续题。

06.5.4.8-007 ShouldBroadcastNow 与队列化广播的区别是什么?

一句话结论

ShouldBroadcastNow 在当前进程同步执行广播推送,不入广播队列;ShouldBroadcast 把广播任务推入队列异步发送,牺牲即时性换取主流程不被推送阻塞。

概念解释

同步广播适合必须立即推送、队列不可用或调试场景;队列化广播解耦推送延迟与消费者处理能力。两者都实现广播契约,标记接口决定执行方式。

原理流程

  1. 事件实现 Now 接口:分发时直接调用广播驱动推送。
  2. 事件实现普通广播接口:封装广播任务入队。
  3. 队列 worker 消费任务执行推送。
  4. 主流程不等待推送结果(队列化场景)。

代码或图示

// 同步广播
class InstantNotification implements ShouldBroadcastNow
{
    // broadcastOn / broadcastWith ...
}

// 队列化广播
class QueuedNotification implements ShouldBroadcast
{
    // ...
}

常见误区

  • 在请求高频路径用 Now 广播:外部推送延迟直接计入响应时间。
  • 队列未启动仍依赖广播:队列化事件堆积,前端长时间收不到消息。

追问

  • Now 广播失败会影响主流程吗?答:同步异常在当前进程抛出,需按异常处理策略捕获;队列化失败进入队列重试/失败流程。
  • 如何选择默认方式?答:业务推送走队列化;调试、低并发强实时场景用 Now。

06.5.4.8-008 公共、私有、Presence 频道的访问控制差异是什么?

一句话结论

公共频道(Channel)无需授权即可订阅;私有频道(PrivateChannel)需后端授权回调通过;Presence 频道(PresenceChannel)在私有授权基础上额外跟踪在线成员列表,可广播谁在加入/离开。

概念解释

  • 公共:匿名/登录用户均可订阅,适合公告类。
  • 私有:频道名与资源归属相关,后端校验当前用户是否有权订阅。
  • Presence:授权同时返回成员信息,频道维护在线成员集合。

原理流程

  1. 前端订阅频道,广播驱动向后端发起授权请求(私有/Presence)。
  2. 授权路由回调校验用户归属。
  3. 私有通过即订阅;Presence 额外上报成员信息并维护列表。
  4. 事件按频道类型推送给对应订阅者。

代码或图示

// 公共频道
new Channel('announcements');

// 私有频道
new PrivateChannel('reports.' . $userId);

// Presence 频道
new PresenceChannel('room.' . $roomId);

常见误区

  • 敏感数据走公共频道:未授权用户可直接订阅接收。
  • Presence 频道滥用:成员状态维护有服务端成本,仅在线协作场景使用。

追问

  • 频道名规则有约定吗?答:私有频道前缀由广播驱动约定;业务标识(用户 ID、资源 ID)拼入频道名,授权回调解析。
  • 同一用户多端在线如何处理?答:Presence 按连接/身份维护成员,多端连接的合并规则由驱动与前端库实现决定。

06.5.4.8-009 私有频道授权路由 routes/channels.php 与 Broadcast::channel 如何工作?

一句话结论

授权回调在频道路由文件中用 Broadcast::channel(频道模式, 回调) 注册;订阅私有/Presence 频道时,后端解析频道名调用回调,返回 true 授权通过,回调接收当前认证用户与频道参数。

概念解释

频道路由文件集中定义授权规则。回调签名 function (User $user, string $channelName, ...参数),按资源归属判断;返回布尔值,Presence 场景还可返回成员信息数组。

原理流程

  1. 在频道路由文件登记频道模式与授权回调。
  2. 前端订阅私有频道,驱动请求授权端点。
  3. 后端匹配频道模式,注入用户与参数调用回调。
  4. 回调通过则建立订阅,拒绝则返回 403。

代码或图示

// routes/channels.php
Broadcast::channel('reports.{userId}', function (User $user, int $userId) {
    return $user->id === $userId;
});

Broadcast::channel('room.{roomId}', function (User $user, int $roomId) {
    return $user->inRoom($roomId); // Presence 可返回成员信息数组
});

常见误区

  • 授权回调只判登录不判归属:登录用户可订阅他人资源频道。
  • 频道模式参数名与回调形参不一致:参数注入失败,授权判断拿不到资源 ID。

追问

  • 频道路由文件在哪里加载?答:由广播服务提供者在引导阶段注册;文件路径随版本约定可能不同,以当前版本配置为准。
  • 授权失败前端表现?答:订阅被拒绝,连接进入鉴权失败状态;错误响应码按驱动实现返回。

06.5.4.8-010 广播驱动 pusher / redis / log / null 的差异与选型?

一句话结论

pusher(及兼容服务)托管 WebSocket 推送,前端直连;redis 驱动利用 Redis 发布订阅配合前端 WebSocket 服务;log 驱动把广播写入日志用于开发调试;null 驱动不推送。

概念解释

驱动决定消息送达通道:

驱动 用途 前端接入
pusher/ably 托管实时推送服务 官方前端库直连
redis Redis pub/sub,需自建 WebSocket 网关 自有 WS 服务订阅 Redis
log 开发调试,记录广播载荷 无实时推送
null 禁用广播,不产生推送 无

原理流程

  1. 配置默认广播驱动。
  2. 广播任务按驱动序列化消息。
  3. 驱动发布到对应通道/日志。
  4. 前端经对应连接接收消息。

代码或图示

// 配置项名称与取值以 config/broadcasting.php 为准
'default' => env('BROADCAST_CONNECTION', 'log'),

// 事件中可指定连接
public function broadcastConnection(): string
{
    return 'redis';
}

常见误区

  • 生产用 log 驱动:消息只进日志,前端收不到实时更新。
  • redis 驱动忽略自建 WS 服务:Redis 只做后端 pub/sub,浏览器不能直接订阅 Redis。

追问

  • ably 与 pusher 关系?答:同属托管推送服务,驱动配置按服务提供商选择;具体可用驱动清单以当前版本广播配置为准。
  • 驱动切换需要改事件代码吗?答:频道与载荷定义与驱动无关,切换主要改配置与前端连接层。

06.5.4.8-011 broadcastAs / broadcastWith 如何控制频道名与载荷?

一句话结论

broadcastAs() 自定义广播事件名(默认类名),broadcastWith() 返回推送载荷数组;频道由 broadcastOn() 返回的频道对象决定,三者共同定义推送内容与路由。

概念解释

前端按事件名监听消息;默认事件名为类全名,broadcastAs 可缩短或固定契约名。载荷只包含需要下发的数据,避免把整个模型序列化推给前端。

原理流程

  1. 事件实现广播契约。
  2. broadcastOn 返回频道数组。
  3. broadcastWith 组装下发字段数组。
  4. broadcastAs 设定前端监听的事件名(可选)。

代码或图示

public function broadcastOn(): PrivateChannel
{
    return new PrivateChannel('team.' . $this->team->id);
}

public function broadcastAs(): string
{
    return 'report.generated';
}

public function broadcastWith(): array
{
    return ['report_id' => $this->report->id];
}

常见误区

  • 载荷直接返回 Eloquent 模型:序列化带入隐藏属性与多余字段,应挑字段组装数组。
  • 事件名前后端不一致:前端监听默认类名,后端自定义了别名,消息收不到。

追问

  • 广播载荷带模型 ID 还是模型数据?答:实时通知可带摘要字段;详情由前端按 ID 拉取,减小推送体积。
  • 频道名在哪个方法返回?答:broadcastOn 返回频道对象数组;频道命名规则随驱动约定。

06.5.4.8-012 队列化监听器如何指定连接、队列、延迟与失败处理?

一句话结论

实现 ShouldQueue 契约的监听器成为队列任务,可通过属性或方法指定 $connection、$queue、$delay;失败任务走队列失败流程,可定义 failed 方法处理兜底。

概念解释

队列化监听器与队列任务机制一致:分发时入队,worker 消费。连接/队列名隔离不同优先级任务;延迟控制执行时间;失败回调记录补偿动作。

原理流程

  1. 监听器实现 ShouldQueue(或框架按类属性标记)。
  2. 配置连接、队列名、延迟秒数。
  3. 事件分发时封装任务入队。
  4. worker 执行;失败进入重试/失败队列,failed 方法兜底。

代码或图示

class SendOrderNotification implements ShouldQueue
{
    public ?string $connection = 'redis';
    public string $queue = 'notifications';
    public int $delay = 10;

    public function handle(OrderCreated $event): void { /* ... */ }

    public function failed(Throwable $e): void
    {
        report($e);
    }
}

常见误区

  • 队列监听器构造函数注入不可序列化对象:任务入队序列化失败,只注入可在 handle 解析的依赖。
  • 不设置失败处理:推送/通知静默丢失,需记录告警与补偿。

追问

  • 监听器重试次数在哪里配?答:任务属性 $tries 与队列配置共同控制;具体属性名以版本源码为准。
  • 队列化监听器与同步监听器混在同一事件?答:可以,分发时按各监听器队列标记分别入队或同步执行。

06.5.4.8-013 事件类属性序列化在队列/广播中有什么要求?

一句话结论

进入队列或广播的事件对象会被序列化,属性只应携带可序列化数据(标量、数组、可队列化模型);服务实例、连接、请求对象等不可序列化资源必须避免挂在事件上。

概念解释

序列化后在消费端重建对象。Eloquent 模型可借助模型序列化约定携带主键与类名,取出时重新查询;依赖服务在监听器 handle 中由容器解析,不通过事件传递。

原理流程

  1. 事件构造函数只接收数据对象/ID。
  2. 入队/广播时序列化事件属性。
  3. 消费端反序列化重建事件。
  4. 监听器通过事件 ID 重新查询所需模型。

代码或图示

class ReportReady implements ShouldBroadcast
{
    public function __construct(public readonly int $reportId) {}

    public function broadcastWith(): array
    {
        return ['report_id' => $this->reportId];
    }
}

常见误区

  • 事件持有 Request 或容器引用:序列化报错或消费端状态失效。
  • 携带整份大模型集合:序列化体积大,且消费端数据可能已过期。

追问

  • 模型如何安全入队?答:使用队列化模型序列化约定(如 SerializesModels 特征),存类名与主键,消费端重新加载;具体机制以版本源码为准。
  • 序列化失败如何排查?答:查看队列异常中的不可序列化类型,定位事件属性中的资源对象。

06.5.4.8-014 监听器依赖注入如何由容器解析?

一句话结论

队列化与同步监听器实例都由容器解析,构造函数类型提示的服务按容器绑定注入;handle 方法也可声明类型提示参数,在调用时解析。

概念解释

监听器不是手动 new,分发器解析监听器类时走容器。构造注入适合长期协作依赖;方法注入适合事件数据之外的临时服务。

原理流程

  1. 分发器取得监听器类名。
  2. 容器反射构造函数并解析依赖。
  3. 实例化监听器。
  4. 调用 handle,事件实例与方法依赖一并传入。

代码或图示

class ReportListener
{
    public function __construct(
        private readonly NotificationSender $sender,
    ) {}

    public function handle(ReportGenerated $event, Metrics $metrics): void
    {
        $this->sender->notify($event->report);
        $metrics->increment('report.generated');
    }
}

常见误区

  • 监听器构造函数注入事件实例:事件在 handle 传入,构造期不可用。
  • 队列监听器把依赖写进属性序列化:只在 handle 内解析,属性保持可序列化。

追问

  • 容器未注册的依赖会怎样?答:解析时抛 BindingResolutionException,需补绑定或改用具体类自动解析。
  • 监听器单例复用吗?答:队列 worker 内实例复用行为与任务生命周期相关;避免在监听器属性保存跨任务状态。

06.5.4.8-015 事件停止传播(stopPropagation)如何实现?

一句话结论

监听器在 handle 中返回特定标记(或调用分发器停止方法,具体 API 以版本源码为准)可阻止后续监听器继续执行;用于某监听器已处理完毕、其余监听不应再响应的场景。

概念解释

默认事件分发给全部匹配监听器。需要短路时,监听器通知分发器停止传播;停止语义与返回值约定需核对当前版本事件分发器实现,避免依赖未文档化行为。

原理流程

  1. 分发器遍历监听器清单。
  2. 当前监听器判断需要短路。
  3. 调用停止传播入口或返回停止标记。
  4. 分发器中断后续监听器调用。

代码或图示

class FirstHandler
{
    public function handle(OrderCreated $event)
    {
        // 已按业务规则处理,阻止其余监听器
        // 停止传播 API 名称以当前版本 Dispatcher 源码为准
    }
}

常见误区

  • 用抛异常替代停止传播:异常走错误处理流程,不等同于正常短路,后续清理逻辑可能受影响。
  • 依赖未确认的返回值约定:先核对分发器源码支持的停止方式再使用。

追问

  • 停止传播影响广播吗?答:广播任务随事件分发入队;若在监听器层停止传播,后续监听器不执行,已注册的广播行为按其触发时机确认。
  • 如何确认版本支持哪种停止方式?答:阅读 Illuminate\Events\Dispatcher 中监听器调用与返回值判断逻辑。

06.5.4.8-016 模型事件与自定义业务事件如何分层使用?

一句话结论

模型事件绑定数据生命周期(创建、更新、删除的内部副作用);自定义业务事件表达领域发生的事实(订单已创建、报告已生成),供跨模块订阅与广播;避免把业务通知写进模型钩子。

概念解释

分层原则:模型层只关心自身持久化,业务事实由服务层分发领域事件。跨模块协作、前端推送、审计通知订阅业务事件;模型观察者保持内聚。

原理流程

  1. 模型保存触发模型事件,处理内部一致性(关联清理、派生字段)。
  2. 服务层完成业务用例后 event(领域事件)。
  3. 监听器订阅领域事件,执行通知、广播、同步索引等。
  4. 模块间通过事件解耦,不直接互相调用。

代码或图示

// 服务层
public function createOrder(array $data): Order
{
    $order = Order::create($data);
    event(new OrderCreated($order));
    return $order;
}

常见误区

  • 模型 created 钩子里发跨模块通知:模型依赖外部模块,复用与测试困难。
  • 业务事件在模型构造函数里分发:对象尚未持久化,事件数据不完整。

追问

  • 一个用例可以分发多个领域事件吗?答:可以,按业务事实逐个分发;监听器独立订阅,互不影响。
  • 模型事件需要广播给前端吗?答:前端推送应通过业务事件实现 ShouldBroadcast;模型钩子不直接承担推送职责。

06.5.4.8-017 广播事件授权回调中如何校验当前用户归属?

一句话结论

授权回调接收认证用户与频道参数,按资源归属关系判断(用户 ID 匹配、成员关系、团队权限),通过返回 true 或成员信息,否则拒绝;校验规则与动作 Policy 保持一致口径。

概念解释

频道名携带资源标识(如 reports.{userId}),回调解析参数后查询归属。授权逻辑复用权限判断方法,避免频道授权与接口授权两套口径。

原理流程

  1. 前端订阅频道,驱动携带认证信息请求授权端点。
  2. 回调取得当前用户与频道参数。
  3. 查询用户与资源归属关系。
  4. 有权限返回 true/Presence 信息;无权限返回 false。

代码或图示

Broadcast::channel('reports.{reportId}', function (User $user, int $reportId) {
    $report = Report::find($reportId);
    return $report !== null && $report->user_id === $user->id;
});

常见误区

  • 回调只检查登录状态:登录不等于有权访问该资源。
  • 授权查询未走作用域/权限规则:与接口 Policy 口径不一致,出现直链越权。

追问

  • Presence 授权返回什么?答:除布尔结果外可返回成员展示信息数组;具体返回结构以广播文档为准。
  • 授权回调性能如何控制?答:按索引字段查询归属,避免在回调中重聚合;高频频道可缓存成员关系。

06.5.4.8-018 广播队列积压与重连失败如何排查?

一句话结论

先核对广播任务是否入队、worker 是否消费;积压看队列长度与消费速率,推送失败看驱动连接配置、凭证与网络;日志区分“未入队”“未消费”“推送失败”三段。

概念解释

广播链路:事件分发 → 广播队列 → worker → 驱动连接 → 频道推送。每段都可能断裂。排查按段定位:队列监控看积压,worker 日志看消费异常,驱动日志看推送错误。

原理流程

  1. 确认事件实现广播契约,配置默认驱动。
  2. 检查队列中广播任务数量与 worker 运行状态。
  3. 查看 worker 异常:序列化失败、连接拒绝、凭证无效。
  4. 驱动层核对频道推送记录与前端订阅状态。

代码或图示

# 队列与失败任务查看(命令名以版本为准)
php artisan queue:work redis --queue=broadcasting
php artisan queue:failed

常见误区

  • 只看前端收不到消息就改前端:后端队列与驱动可能早已失败。
  • 广播失败不进失败队列:异常被吞掉,需在监听器/广播异常记录中核对。

追问

  • redis pub/sub 积压会堆积吗?答:pub/sub 不留存消息,消费者离线期间消息丢失;需要持久化应选队列驱动或托管推送服务。
  • 如何监控广播成功率?答:在广播任务成功/失败回调打点计数,结合队列失败任务数量告警。

06.5.4.8-019 事件订阅者如何在一个类里绑定多个监听方法?

一句话结论

订阅者实现订阅契约,subscribe 方法返回“事件类 → 处理方法名”映射数组;框架注册后,相关事件分发时调用订阅者对应方法,一个类集中管理一组关联监听。

概念解释

订阅者适合 cohesive 的一组事件:如订单模块的创建、更新、取消都在同一订阅类处理。方法接收对应事件实例,依赖由容器注入构造函数。

原理流程

  1. 类实现订阅者接口。
  2. subscribe 返回事件到方法名映射。
  3. 应用/提供者注册订阅者类。
  4. 事件触发时分发器调用映射方法。

代码或图示

class OrderSubscriber implements Subscriber
{
    public function subscribe(Dispatcher $events): array
    {
        return [
            OrderCreated::class => 'onCreated',
            OrderCancelled::class => 'onCancelled',
        ];
    }

    public function onCreated(OrderCreated $event): void { /* ... */ }
    public function onCancelled(OrderCancelled $event): void { /* ... */ }
}

常见误区

  • 映射方法不存在:事件触发时调用失败,需核对方法名与可见性。
  • 订阅者未注册到事件配置:subscribe 不会被框架调用。

追问

  • 订阅者支持队列化吗?答:按队列监听器规则标记;订阅方法是否入队取决于类契约与属性配置,以源码为准。
  • 订阅者与多个独立监听器如何选?答:事件紧密关联、共享依赖用订阅者;独立模块各自订阅用独立监听器。

06.5.4.8-020 同步分发与队列分发在事务回滚场景下注意什么?

一句话结论

事务提交前分发的队列任务可能在回滚后被消费,导致基于未提交数据执行;应在事务提交后再分发队列/广播任务,或利用事务提交回调机制,避免脏数据触发异步副作用。

概念解释

队列任务入队不依赖主事务提交;若任务在事务回滚前入队,消费端可能读到不存在或已回滚的数据。同步监听器在事务内执行可见未提交数据,需注意一致性边界。

原理流程

  1. 业务操作包裹在数据库事务中。
  2. 避免事务内直接分发队列化事件。
  3. 事务提交后再触发异步事件,或注册提交后回调。
  4. 消费端按持久化后的 ID 重新查询数据。

代码或图示

DB::transaction(function () use ($data) {
    $order = Order::create($data);
    // 队列化事件延迟到提交后分发(具体机制以版本支持为准)
    event(new OrderCreated($order));
});

常见误区

  • 入队即认为数据已提交:队列消费可能先于主事务提交或在回滚后启动。
  • 异步任务信任事件快照数据:回滚后快照与库不一致,任务应按 ID 重新查询并校验存在性。

追问

  • 框架有事务提交后分发机制吗?答:部分版本提供提交后回调/事务感知队列配置;具体能力与配置项需核对当前版本文档与源码,属待确认项。
  • 同步监听器在事务内能读到未提交数据吗?答:同一连接内可见未提交变更;跨连接/队列任务不可见,边界需按连接与事务隔离级别确认。