Laradock环境搭建Laravel Echo Server前端WS连接成功但无法订阅频道

1. 首先确认laravel-echo-server配置项 #

• 检查laravel-echo-server.json中的devMode是否设为true，该选项关闭时不会输出连接、订阅相关的日志，你看不到连接记录大概率是这个配置的问题。
• 检查databaseConfig.redis.keyPrefix配置，要和你Laravel项目.env中的REDIS_PREFIX值完全一致（默认是laravel_database_），前缀不匹配会导致频道无法对应。

2. 检查前端依赖版本匹配 #

Laravel Echo和socket.io-client的版本必须兼容，当前主流搭配为：

• laravel-echo @ 1.11.x 对应 socket.io-client @ 4.x
  如果版本不匹配，会出现连接正常但订阅请求无法发出的问题，你可以执行以下命令重装匹配版本：

npm uninstall laravel-echo socket.io-client
npm install laravel-echo@^1.11.0 socket.io-client@^4.0.0

3. 调整前端代码执行逻辑 #

你当前的订阅代码是在Echo实例化后立即执行，此时Socket连接还未完成握手，订阅请求会静默失败。调整代码，把订阅逻辑放到连接成功的回调中，同时增加调试配置：

window.echo = new Echo({
    broadcaster: 'socket.io',
    host: 'localhost:6001',
    // 本地HTTP访问需关闭强制TLS，避免请求被自动跳转到HTTPS
    forceTLS: false,
    // 开启客户端调试日志，可在控制台看到完整的连接、订阅交互信息
    debug: true
});

// 监听连接成功事件后再执行订阅
window.echo.connector.socket.on('connect', () => {
    console.log('Socket连接已建立，开始订阅频道');
    window.echo.channel('laravel_database_test')
        .listen('.Test', e => {
            console.log('收到事件数据：', e)
        })
})

4. 验证配置生效 #

修改完以上配置后重启laravel-echo-server，清空浏览器缓存重新加载页面：

• 开启devMode后会在Echo Server日志看到连接、订阅的完整记录
• 再次调用/apps/../channels接口，会看到你订阅的laravel_database_test频道出现在返回结果中
• Laravel端触发事件后前端控制台就能打印出对应事件数据

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