如何在前端通过WebSockets结合Redis Pub/Sub实现实时聊天室

酷墨小哥_5216

酷墨小哥_5216

2026-10-03

554人浏览

原创

前端无法直连 redis pub/sub,因其协议不兼容 websocket 标准;前端只需连接自身 websocket 服务并收发 json 消息,后端负责 redis 订阅、发布与状态同步。

如何在前端通过websockets结合redis pub/sub实现实时聊天室

前端无法直接连接 Redis Pub/Sub,这是个常见误解。Redis 的 Pub/Sub 机制运行在服务端,前端 WebSocket 客户端只能与你的应用服务器通信,所有 Redis 操作必须由后端完成。

为什么前端不能直连 Redis Pub/Sub

Redis 默认不开放公网访问,且其协议不是基于 HTTP/HTTPS 的浏览器可兼容协议;浏览器的 WebSocket API 只能连接符合 WebSocket 协议(RFC 6455)的服务端,而 Redis 的 Pub/Sub 是 TCP 层面的原生命令交互,不支持握手升级、帧格式、跨域等 Web 标准。

  • 尝试用 new WebSocket("redis://...") 会直接报错或连接失败
  • 即使通过 WebSocket 代理桥接 Redis,也需额外服务层(如 Node.js 中间件),本质仍是“前端 → 自己的 WS 服务 → Redis”
  • 浏览器中无法执行 PUBLISH 或 SUBSCRIBE 命令——这些是 Redis CLI 或服务端 SDK 的能力

前端该做什么:只管连接、收发、状态管理

前端唯一要做的,是建立并维护一条到你自己的 WebSocket 服务(如 /ws)的稳定连接,并按约定的消息格式发送和解析数据。其余逻辑全部交给后端处理。

PigX UI 前端开发
PigX UI 前端开发

PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。

下载
  • 连接时携带认证信息,例如把 token 放在 URL 查询参数:ws://your-api.com/ws?token=abc123
  • 发送消息用标准 JSON 格式,包含 type、to(群聊/用户ID)、content 字段,避免裸字符串
  • 监听 message 事件,对 event 字段做分支处理(如 "join"、"msg"、"offline")
  • 主动实现心跳(如每 30 秒发一次 {"ping": true}),防止 Nginx 或云厂商 LB 断连

后端必须承担的三件事

真正串联 WebSocket 和 Redis Pub/Sub 的工作,全在服务端。以 Go + Gin + gorilla/websocket 为例:

  • 连接注册:用户上线时,用 redisClient.SAdd("online_users", userID) 记录在线状态
  • 消息分发:收到某用户消息后,不直接广播给所有连接,而是调用 redisClient.Publish("chat:general", payload)
  • 订阅转发:每个 WebSocket 连接对应的 goroutine 需 redisClient.Subscribe("chat:general"),再将收到的 Pub/Sub 消息通过 conn.WriteMessage() 推给对应客户端

容易被忽略的关键点

很多人卡在消息“发出去了但别人收不到”,问题往往不在前端代码,而在后端的订阅生命周期管理——Redis 的 SUBSCRIBE 是长连接,必须和 WebSocket 连接共存亡。

  • 如果用一个全局 redis.PubSub 实例供所有连接共享,断连时未 Unsubscribe,会导致内存泄漏和重复投递
  • 不要在 handleWebSocket 函数里直接 Subscribe 后就 return;必须起一个独立 goroutine 持续 Receive() 并写回 WebSocket
  • 前端看到“已发送”不等于“已送达”,需要后端在成功 Publish 后返回 {"ack": "msg_id"},前端据此更新 UI 状态

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2243

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4803

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5930

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5398

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

763

5

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4249

19

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.14

3755

11

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

6752

6

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

623

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习