Laravel私有Pusher通知推送实现故障排查求助

核心问题与修复步骤 #

1. 前端订阅的私有频道名称错误 #

私有频道必须以private-为前缀，且要匹配后端的notifications.{userId}格式。当前Project B里订阅的是普通频道notifications，完全不匹配后端的私有频道名称。

修改Project B的JS代码：

// 替换成实际的用户ID，比如从登录状态获取
const userId = 1; 
// 订阅正确的私有频道
var channel = pusher.subscribe(`private-notifications.${userId}`);

2. 跨域(CORS)问题 #

Project A和Project B是独立项目，前端请求http://project_a.test/broadcasting/auth会触发跨域拦截，需要在Project A中配置CORS允许Project B的域名。

在Project A的config/cors.php中修改：

return [
    'paths' => ['api/*', 'broadcasting/auth'], // 加入broadcasting/auth路径
    'allowed_methods' => ['*'],
    'allowed_origins' => ['http://project_b.test'], // 替换成Project B的实际域名
    'allowed_origins_patterns' => [],
    'allowed_headers' => ['*'],
    'exposed_headers' => [],
    'max_age' => 0,
    'supports_credentials' => true, // 开启凭证支持，用于Session认证
];

3. 频道认证时用户未登录/凭证缺失 #

Broadcast::channel回调中的$user是Laravel的认证用户实例，如果前端没有传递登录凭证，$user会为null，导致认证失败。

情况1：使用Session认证（同域或共享Session）

确保Project B的请求携带Project A的Session Cookie，需要：

• 两个项目配置相同的SESSION_DOMAIN（比如.test）
• Project B的JS中开启withCredentials：

var pusher = new Pusher('PUBLIC_PUSHER_KEY', {
    cluster: 'eu',
    authEndpoint: 'http://project_a.test/broadcasting/auth',
    auth: {
        headers: {
            'X-CSRF-Token': '你的CSRF令牌' // 如果需要，从Project A获取CSRF令牌
        },
        withCredentials: true // 携带Cookie
    }
});

情况2：使用Token认证（无Session）

修改Broadcast::channel支持Token认证，同时前端传递Token：
Project A的routes/channels.php：

use Illuminate\Http\Request;

Broadcast::channel('notifications.{userId}', function (Request $request, $userId) {
    // 从请求头获取Token并验证用户
    $token = $request->header('Authorization');
    $user = auth()->guard('api')->setToken(str_replace('Bearer ', '', $token))->user();
    
    return $user && (int) $user->id === (int) $userId;
});

Project B的JS：

var pusher = new Pusher('PUBLIC_PUSHER_KEY', {
    cluster: 'eu',
    authEndpoint: 'http://project_a.test/broadcasting/auth',
    auth: {
        headers: {
            'Authorization': 'Bearer 用户的API令牌' // 替换成实际用户的Token
        }
    }
});

4. 后端频道路由未正确注册 #

确保Project A的routes/channels.php中的频道路由被正确加载，Laravel默认会自动加载这个文件，但如果有自定义配置，需要确认BroadcastServiceProvider已启用：

检查config/app.php中的providers数组：

'providers' => [
    // ...
    Illuminate\Broadcasting\BroadcastServiceProvider::class,
    // ...
],

验证步骤 #

1. 启动Project A和Project B，确保CORS配置生效
2. 前端登录用户（确保有合法的用户ID和凭证）
3. 触发Project A的事件，推送消息到private-notifications.{userId}频道
4. 打开浏览器控制台，查看Pusher的日志，确认订阅成功且收到消息

内容的提问来源于stack exchange，提问作者Email Puna