Laravel 11升级后Pusher私有频道授权失败问题排查

问题概述 #

通过Laravel Shift从Laravel 10升级到11后，Pusher私有频道无法正常授权，控制台持续报错Auth info required to subscribe to private-users.2。已确认授权请求能到达Illuminate\Broadcasting › BroadcastController@authenticate，但频道授权回调未触发，仅返回空200响应；channels.php配置正确，php artisan channel:list能识别目标频道，且已完成bootstrap/app.php引入、php artisan install:broadcasting等基础配置。

排查与解决步骤 #

1. 确认广播路由的中间件配置 #

Laravel 11对广播路由的注册逻辑有调整，需确保路由绑定了正确的认证中间件。在bootstrap/app.php中检查广播路由的注册代码：

use Illuminate\Support\Facades\Broadcast;

// 确保路由使用web和auth中间件，授权必须依赖用户认证
Broadcast::routes(['middleware' => ['web', 'auth']]);

若之前通过install:broadcasting自动生成配置，仍需确认中间件未被误删或修改。

2. 验证频道授权类的触发状态 #

在UsersChannel的join方法中添加日志，确认方法是否真的未被调用：

namespace App\Broadcasting;

use App\Models\User;
use Illuminate\Support\Facades\Log;

class UsersChannel
{
    public function __construct()
    {
        //
    }

    public function join(User $user, int $id): array|bool
    {
        Log::info('UsersChannel授权触发', ['用户ID' => $user->id, '频道ID' => $id]);
        return (int) $user->id === (int) $id;
    }
}

执行授权请求后查看storage/logs/laravel.log，若未找到对应日志，说明频道注册与控制器之间的映射存在问题。

3. 测试闭包形式的频道授权 #

临时将channels.php中的频道配置改为闭包形式，验证授权逻辑本身是否正常：

// channels.php
use App\Models\User;

Broadcast::channel('users.{id}', function (User $user, int $id) {
    return (int) $user->id === (int) $id;
});

若闭包形式能正常完成授权，说明问题出在频道类的解析或注册环节，可尝试重新生成类文件的自动加载缓存：

composer dump-autoload

4. 检查Echo的授权请求配置 #

确认前端Echo的authorizer配置是否正确携带CSRF令牌和请求参数，Laravel 11的/broadcasting/auth端点默认需要CSRF保护：

window.Echo = new Echo({
    broadcaster: 'pusher',
    key: import.meta.env.VITE_PUSHER_APP_KEY,
    cluster: import.meta.env.VITE_PUSHER_APP_CLUSTER,
    forceTLS: true,
    authorizer: (channel) => {
        return {
            authorize: (socketId, callback) => {
                axios.post('/broadcasting/auth', {
                    socket_id: socketId,
                    channel_name: channel.name
                }, {
                    headers: {
                        'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content
                    }
                }).then(response => {
                    callback(false, response.data);
                }).catch(error => {
                    callback(true, error);
                });
            }
        };
    }
});

5. 清除缓存残留 #

升级后旧缓存可能干扰新配置，执行以下命令清除各类缓存：

php artisan cache:clear
php artisan route:clear
php artisan config:clear

内容的提问来源于stack exchange，提问作者Kody Wright