Echo 是 Laravel 官方前端广播客户端库，不提供 WebSocket 服务，仅依赖外部服务（如 Pusher 或 laravel-websockets）实现连接；其本身不监听端口、不处理握手、不管理连接生命周期。
原生 WebSocket 扩展在 Echo 框架中并不存在——Echo 是 Laravel 官方提供的前端广播客户端库，它本身不提供、也不扩展任何 WebSocket 服务器能力。
为什么 Echo 不能“原生支持 WebSocket”
Echo 的设计定位非常明确：它只负责前端订阅和事件监听，底层连接完全依赖外部 WebSocket 服务端。它默认尝试连接 ws://localhost:6001（Laravel WebSockets）或 wss://ws-us2.pusher.com（Pusher），但这些都不是 Echo 自己启动的。
-
Echo没有内置 WebSocket 服务逻辑，不监听端口，不处理握手，不管理连接生命周期 - 所谓“集成 WebSocket”，实际是配置
BROADCAST_DRIVER为redis或pusher，再由对应服务端（如laravel-websockets进程）承担真实长连接 - 如果误以为
php artisan serve能跑 WebSocket，会发现echo.channel().listen()静默失败，控制台只报WebSocket connection to '' failed
laravel-websockets 启动后仍连不上？检查三个头字段
Nginx/Apache 反向代理时极易丢弃 WebSocket 升级必需的 HTTP 头，导致握手失败（400 或直接断连）。
- 必须透传
Upgrade: websocket—— Nginx 配置里要写proxy_set_header Upgrade $http_upgrade; - 必须透传
Connection: upgrade—— 对应写proxy_set_header Connection "upgrade"; - 确保
proxy_http_version 1.1已启用，否则 Upgrade 头无效
漏掉任意一项，laravel-websockets 进程日志里可能只显示 “handshake failed”，但不会明确指出缺哪个头。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
高并发推送卡在单机广播？别遍历 $connections
当使用 laravel-websockets 自建服务时，很多人直接在事件监听里写循环发消息：
foreach ($this->connections as $conn) {
$conn->send(...);
}
这在连接数超 500 后就会明显延迟，因为 PHP 是单线程，同步发送阻塞整个 event loop。
- 正确做法是把消息推到 Redis Pub/Sub 或 Kafka，由独立消费者进程异步分发
- 若坚持用
laravel-websockets，应启用其内置的「广播队列」机制：QUEUE_CONNECTION=redis php artisan websockets:serve - 注意
laravel-websockets的max_connections默认是 1000，超限会拒绝新连接且无提示
私有频道认证失败却没报错？检查 /broadcasting/auth 响应格式
前端调用 echo.private('user.123') 时，Echo 会自动 POST 到 /broadcasting/auth，但这个端点必须满足两个硬性条件：
- 返回 HTTP 200 状态码（403/401 会被前端静默吞掉，只显示“Access denied”）
- 响应体必须是 JSON，且含
auth字段（例如{"auth":"v2:..."}），不能多字段也不能少 - 该路由必须注册在
routes/channels.php中，且中间件web不能干扰 session 读取（建议显式加auth:sanctum或auth:api）
最容易被忽略的是：Laravel 10+ 默认禁用 session 在 API 路由中，而 /broadcasting/auth 若走 api 中间件组，session 就为空，认证必然失败。
