Pusher 是第三方 WebSocket 服务,Laravel 仅通过广播系统推送事件;本地 HTTP 可连因浏览器放行 localhost,上线需 wss://;Nginx/Apache 需透传 Upgrade 和 Connection 头;.env 中 PUSHER_SCHEME=http 无效,前端须设 forceTLS: true;广播失败常见原因包括:BroadcastServiceProvider 未正确注册、BROADCAST_DRIVER 配置错误、事件类未实现 ShouldBroadcast、私有频道鉴权路由误用 web 中间件、auth 响应格式不符、频道名不一致、前端 KEY 未用 MIX_ 前缀、三处 Pusher 配置未对齐。
Pusher 不是 Laravel 的 WebSocket 插件,Laravel 本身不运行 WebSocket 服务器;它只是通过广播系统把事件推给 Pusher 托管的 WebSocket 服务。前端用
或
连接 Pusher 的 wss:// 端点,不是连你自己的 PHP 进程。
为什么本地 HTTP 能连上 Pusher,但上线就报 SecurityError?
现代浏览器强制要求 WebSocket 在非
域名下必须走
(即 HTTPS + WebSocket)。这不是 Laravel 或 Pusher 设的限,是浏览器策略。
开发时用
可以通,因为浏览器对
放行不安全连接
一旦部署到
,
会直接拒绝建立连接,并抛出
Nginx/Apache 必须透传
和
头,否则连接会降级为长轮询并静默失败
里写
没用——
包根本不读这个配置;前端初始化时才需要显式设
广播事件没触发,
注册对了但还是收不到?
漏掉任一环节都会导致
完全静默:后端不报错、Redis 无记录、前端监听不到。
中
必须在
数组里,且不能被条件包裹或注释掉
的
必须生效,且
中
拼写不能错
广播事件类必须实现
接口,
返回有效频道实例(如
),不能返回空数组或
私有频道需认证端点
,该路由**不能加
中间件**(会塞 session cookie 导致跨域预检失败),应改用
中间件或自定义无 session 的中间件
订阅失败,控制台只显示
这是私有频道鉴权失败的典型表现,问题几乎总出在后端响应格式或前端配置上。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记(深入)
”;
前端
必须指向 Laravel 的认证路由(默认是
),别写成
却忘了配路由前缀
响应体必须是
,且
;返回
会导致前端卡在 “connecting” 状态
频道名大小写敏感、前后空格、整数拼接(如
中
是
还是
)都会让前后端频道名不一致
前端 JS 读不到
—— 必须在
中写成
,再经 Laravel Mix 编译注入;
为空?90% 是忘了加
前缀
最容易被忽略的是三处配置对齐:
、
、
中的 Pusher 配置必须完全一致;
填错(比如新应用该填
却写了
)会导致静默失败,控制台连错误都不报。
pusher-jsLaravel Echolocalhostwss://http://localhost:8000localhosthttp://example.compusher-jsWebSocket connection failed: SecurityErrorUpgradeConnection.envPUSHER_SCHEME=httppusher-php-serverforceTLS: trueBroadcastServiceProviderevent(new MessageSent($message))config/app.phpBroadcastServiceProvider::classprovidersconfig/broadcasting.php'default' => env('BROADCAST_DRIVER', 'pusher').envBROADCAST_DRIVER=pusherShouldBroadcastbroadcastOn()new PrivateChannel('chat.' . $this->roomId)nullPOST /broadcasting/authwebapiEcho.private('chat.123')Subscription to private-chat.123 failedauthEndpoint/broadcasting/auth/api/broadcasting/auth{"auth":"xxx:yyy"}Content-Type: application/json{"error": "unauthorized"}'chat.' . $id$idintstringPUSHER_APP_KEY.envMIX_PUSHER_APP_KEY=xxxprocess.env.MIX_PUSHER_APP_KEYMIX_.envconfig/broadcasting.phpconfig/services.phpPUSHER_APP_CLUSTERmt1us2