私有频道和存在频道必须返回PrivateChannel或PresenceChannel实例且频道名以private-或presence-开头，否则前端报Channel not found或403；BROADCAST_CHANNEL_PREFIX仅影响Redis底层key，与前端订阅路径无关。
私有频道和存在频道必须用 PrivateChannel 或 PresenceChannel 类实例返回，不能返回字符串；频道名必须以 private- 或 presence- 开头，否则前端 Echo.private() 或 Echo.join() 会直接报 Channel not found 或 403 错误。
私有频道名必须带 private- 前缀
这是广播协议层的硬性要求，不是 Laravel 自定义规则。Pusher、Redis + Laravel WebSockets、Ably 等主流驱动都强制校验该前缀。
-
new PrivateChannel('private-user.123')✅ 前端可正常订阅Echo.private('private-user.123') -
new PrivateChannel('user.123')❌ 即使后端没报错，前端连接成功后也收不到事件，控制台可能静默失败 - 前缀不区分大小写，但建议统一小写，避免在 CI/CD 或跨环境部署时因大小写敏感出问题
-
BROADCAST_CHANNEL_PREFIX环境变量只影响 Redis 底层 key 命名（如laravel_database_private-user.123:members），和前端订阅路径完全无关
broadcastOn() 必须返回频道类实例，不能返回字符串
Laravel 8+ 已彻底弃用字符串返回方式。返回字符串不仅跳过权限检查，还会绕过 broadcastWith() 的数据过滤逻辑，构成安全风险。
- 正确：
return new PrivateChannel('private-order.' . $this->order->id); - 错误：
return 'private-order.' . $this->order->id;→ 触发InvalidArgumentException - 若需同时推送到多个频道，返回数组：
return [new PrivateChannel(...), new PresenceChannel(...)] - 频道构造函数只接受字符串，传
object或array会抛TypeError
存在频道需额外配置授权并支持成员管理
PresenceChannel 继承自 PrivateChannel，但多了用户状态同步能力，依赖服务端维护在线成员列表，因此对授权逻辑和广播驱动有更高要求。
- 必须在
routes/channels.php中为对应频道名定义授权回调，例如：Broadcast::channel('presence-chat.{id}', function ($user, $id) { ... }) - 前端必须用
Echo.join('presence-chat.123')，不能用Echo.private()，否则无法获取成员列表或加入/离开事件 - Redis 驱动下，成员信息存于
:members后缀的 key 中，需确保 Redis 连接稳定且未被清理 - 若用 Laravel Reverb，需确认其
PresenceChannel实现已启用（默认开启），且未被中间件拦截心跳请求
最容易被忽略的是：频道名前缀和频道类实例这两点，一旦出错，现象往往是“连接成功但收不到消息”，排查时容易陷入网络或队列问题，实际卡在命名或返回类型上。
