Laravel WebSocket 本地连接 Puher 失败的解决方案

本地开发时 laravel websockets 报“failed to connect to pusher”错误，实为广播配置误用 pusher 官方服务而非本地 websocket 服务器所致；只需禁用 tls 并指向本地 `127.0.0.1:6001`，即可让事件广播正确路由至自托管 websocket 服务。

该错误的根本原因在于：你正在使用 beyondcode/laravel-websockets 搭建本地 WebSocket 服务器，但 broadcasting.php 中的 pusher 配置仍默认尝试连接 Pusher 官方云服务（尤其是启用了 TLS 或未显式覆盖 host/port 时）。虽然配置中已设置 host => 127.0.0.1 和 port => 6001，但 pusher-php-server SDK 在 useTLS => true（默认行为）下会强制使用 https:// 协议和 443 端口，导致与本地 HTTP 服务（http://127.0.0.1:6001）协议不匹配，最终触发连接超时并报错 Failed to connect to Pusher.。

值得注意的是，即使连接失败，Laravel 的广播机制仍会继续执行后续逻辑（如触发事件回调），因此你观察到“错误后事件仍被发出”——这并非事件成功广播，而是广播驱动降级失败后，框架未中断流程所致，实际客户端并未收到消息。

✅ 正确配置方式如下（以 config/broadcasting.php 为准）：

baidu-map-jsapi-three

使用 MapV-Three 构建专业的 3D 地图和 GIS 应用 - 基于 Z-up 坐标系的 3D 地图库，支持地图编辑、测量工具、要素绘制、数据管理等地理可视化功能。适用于创建地图编辑器、测量工具、空间数据可视化等 Web-GIS 应用。

下载

⚠️ 注意事项：

• 删除或注释掉 timeout => 1：过短的超时（如 1 秒）易因本地网络延迟导致误判失败；
• 确保 laravel-websockets 服务正在运行：php artisan websockets:serve，且监听 0.0.0.0:6001（非仅 127.0.0.1，避免 Docker 或跨网络访问问题）；
• .env 中 PUSHER_APP_CLUSTER 值（如 mt1）仅作标识用途，本地服务不依赖真实 Pusher 集群，可保留也可设为任意字符串（如 local），但需与前端 JS 初始化时的 cluster 保持一致；
• 若使用 Laravel Echo 前端，确保初始化时也关闭 TLS：复制AI写代码

  1 2 3 4 5 6 7 8 9

  window.Echo = new Echo({     broadcaster: pusher,     key: import.meta.env.VITE_PUSHER_APP_KEY,     cluster: import.meta.env.VITE_PUSHER_APP_CLUSTER,     wsHost: window.location.hostname,     wsPort: 6001,     forceTLS: false, // ? 同样关键     disableStats: true, });

总结：这不是 Pusher 凭据或网络连通性问题，而是协议与服务目标错配。将广播驱动明确指向本地 HTTP WebSocket 服务，并关闭 TLS，即可彻底解决该错误，确保事件真正触达客户端。