Laravel Echo+Pusher订阅私有频道提示「需认证信息」问题求助

问题场景 #

使用Laravel结合Pusher实现移动端API的广播功能，配置了Sanctum认证中间件，但移动端通过Laravel Echo连接私有频道时，始终收到错误：

Pusher :  : [{"type":"PusherError","data":{"code":null,"message":"Auth info required to subscribe to private-App.Models.PharmacyUser.1"}}]

即使已携带正确的Bearer Token，仍无法完成私有频道认证。

核心排查与解决步骤 #

1. 修正广播认证路由的URL前缀 #

你的BroadcastServiceProvider中已为广播路由添加了api前缀：

Broadcast::routes(["prefix" => "api", "middleware" => ["auth:sanctum"]]);

但客户端请求的认证URL是https://api.*********.com/broadcasting/auth，缺少了api前缀，正确的URL应该是：

'https://api.*********.com/api/broadcasting/auth'

这是导致认证请求失败的最常见原因——Laravel无法匹配到正确路由，返回404或未授权，Pusher因此判定认证信息缺失。

2. 验证Sanctum状态域配置 #

确保config/sanctum.php中的stateful数组包含你的API域名，避免跨域认证问题：

'stateful' => explode(',', env('SANCTUM_STATEFUL_DOMAINS', 'localhost,127.0.0.1,api.*********.com')),

同时在.env中设置正确的SESSION_DOMAIN：

SESSION_DOMAIN=.*********.com

（注意域名前的点，用于支持子域共享会话）

3. 确认频道订阅的格式 #

Laravel Echo会自动为私有频道添加private-前缀，因此客户端订阅时只需使用原始频道名，无需手动添加前缀：

// 正确写法
echo.private('App.Models.PharmacyUser.1')
  .listen('YourEventName', (eventData) => {
    console.log(eventData);
  });

// 错误写法（不要手动加private-）
// echo.private('private-App.Models.PharmacyUser.1')

4. 调试认证请求的详细错误 #

修改客户端的authorize函数，打印完整的错误响应，定位具体问题：

catch (error) {
  // 打印完整错误信息，包括Laravel返回的响应内容
  console.log('WS认证错误详情:', error.response?.data || error.message);
  callback(true, error);
}

通过日志可以明确是路由不存在、Token无效还是其他认证问题。

5. 保持Pusher配置的一致性 #

客户端的Pusher key和cluster必须与Laravel .env中的配置完全一致，建议从环境变量读取，避免手动写死错误值：

// 示例：使用react-native-dotenv加载环境变量
import { PUSHER_APP_KEY, PUSHER_APP_CLUSTER } from '@env';

export default new Echo({
    broadcaster: 'pusher',
    Pusher,
    key: PUSHER_APP_KEY,
    cluster: PUSHER_APP_CLUSTER,
    // ...其他配置
});

6. 完善频道授权的验证逻辑 #

虽然当前频道回调返回true，但建议严格验证用户与频道的关联关系，同时确认$user对象是否正常获取：

Broadcast::channel('App.Models.PharmacyUser.{id}', function ($user, $id) {
    // 记录日志，确认用户是否通过认证
    \Illuminate\Support\Facades\Log::info('频道认证用户信息', ['user' => $user]);
    // 验证用户ID与频道ID匹配，确保安全性
    return $user && (string)$user->id === (string)$id;
});

查看Laravel日志（storage/logs/laravel.log），确认$user不为null，说明Sanctum认证正常。

内容的提问来源于stack exchange，提问作者Jarliev Pérez