laravel广播需完整配置：启用broadcastserviceprovider、正确设置broadcast_driver及对应环境变量、事件类实现shouldbroadcast并返回频道实例、前后端频道名严格一致、运行队列服务，任一环节缺失均导致广播失败。
广播在 Laravel 里不是“配完就能用”的功能，漏掉任一环节——比如服务提供者没启用、驱动没生效、事件没声明接口、前端频道名不匹配——都会导致 broadcast() 静默失败或直接报 BadMethodCallException: Method broadcast does not exist。
必须启用 BroadcastServiceProvider 才能触发广播
新版 Laravel 默认注释掉了这个服务提供者，不手动打开，整个广播系统压根不会加载，ShouldBroadcast 接口形同虚设。
- 打开
config/app.php，在providers数组中取消注释：App\Providers\BroadcastServiceProvider::class - 确认
app/Providers/BroadcastServiceProvider.php的boot()方法里调用了Broadcast::routes() - 如果用了 API 路由前缀（如
Route::prefix('api')），得显式传参：Broadcast::routes(['prefix' => 'api', 'middleware' => ['auth:api']])，否则/api/broadcasting/auth会 404
BROADCAST_DRIVER 和环境变量必须严丝合缝
只改 config/broadcasting.php 没用，.env 才是开关。驱动不生效，broadcast(new MyEvent) 就等于白调。
-
BROADCAST_DRIVER=redis或pusher必须写在.env中；null或log仅用于调试，不触发前端监听 - 选
pusher时，PUSHER_APP_ID、PUSHER_APP_KEY、PUSHER_APP_SECRET、PUSHER_APP_CLUSTER四个变量缺一不可，漏一个就会在php artisan config:clear后卡在认证路由 401 或 404 - 选
redis时，确保config/broadcasting.php中的connection值（如default）与config/database.php里redis配置的键名一致，否则报Connection refused
事件类要正确实现 ShouldBroadcast 并返回频道实例
光 dispatch 事件不行，必须让框架知道“这个事件要广播”，且明确告诉它“往哪播”。toBroadcast() 是旧版写法，现在已无效。
- 事件类需
implements ShouldBroadcast，并use InteractsWithSockets和SerializesModels -
broadcastOn()方法必须返回Channel、PrivateChannel或PresenceChannel实例，不能返回字符串 - 私有频道名必须以
private-开头，例如new PrivateChannel('private-user.123')；前端用Echo.private('private-user.123')，漏掉private-前缀会 403 - 若用模型事件（如
created），加public $broadcastWhen = ['created']控制时机，否则可能在事务未提交时就广播
前端频道名和权限逻辑必须完全对齐后端
后端用 private-user.123，前端就得写 private-user.123，大小写、连字符、前缀一个都不能错；而且私有通道必须通过 /broadcasting/auth 验证，否则直接被拒绝。
- 认证失败时浏览器控制台会显示
403 Forbidden或419 unknown status，此时看routes/channels.php里对应通道的闭包是否返回true，且用户已登录 - 使用
PresenceChannel时，前端必须调用.here()和.joining()才能拿到在线用户列表，光监听事件没用 -
toBroadcast()和broadcastOn()别混用：事件类里定义广播目标，只用broadcastOn()就够了；toBroadcast()是 Laravel 5.x 旧写法，现在调用它会静默忽略，但 IDE 可能不报错，导致通道订阅始终为空
最容易被忽略的是队列服务本身——广播事件默认走队列，不运行 php artisan queue:work，事件发出去但没人处理；另外，log 驱动虽能打印日志，但它不建立 WebSocket 连接，前端永远收不到，别把它当“通了”的信号。
