如何在JavaScript中使用RabbitMQ与STOMP WebSocket实现实时一对一聊天功能
基于RabbitMQ + STOMP WebSocket的一对一私聊实现方案
你的技术栈适配性很高,以下是可直接落地的实现逻辑:
前置准备
首先开启RabbitMQ的STOMP相关插件:
rabbitmq-plugins enable rabbitmq_web_stomp rabbitmq_stomp
插件开启后RabbitMQ默认会在15674端口暴露WebSocket STOMP接入点,生产环境建议修改默认端口和访问凭证。
注意:不要让前端直接连接RabbitMQ的STOMP端口,会暴露服务凭证,所有连接必须通过Node.js后端做鉴权中转
核心实现逻辑
1. 后端Node.js层(鉴权+消息中转+落盘)
- 首先做连接鉴权:前端发起WebSocket连接时必须携带身份凭证(JWT/会话token),后端校验通过后拿到当前登录用户ID,拒绝非法连接
- 引入
@stomp/stompjs和ws依赖,为每个合法用户建立和RabbitMQ的STOMP长连接,使用RabbitMQ原生支持的/user前缀路由规则做一对一消息投递 - 消息落盘逻辑:收到前端发送的聊天消息后,先将发送者ID、接收者ID、消息内容、时间戳、消息唯一ID写入PostgreSQL,标记为
未发送状态,投递到RabbitMQ成功后更新为已发送 - 队列命名规则:统一使用
/user/{用户ID}/private_chat作为每个用户的私有消息订阅地址,RabbitMQ会自动为每个订阅创建临时排他队列,用户断开连接后队列自动销毁,不会占用多余资源
示例核心代码片段:
import { Client } from '@stomp/stompjs'; import WebSocket from 'ws'; // 初始化RabbitMQ STOMP客户端 const rabbitStompClient = new Client({ webSocketFactory: () => new WebSocket('ws://localhost:15674/ws'), connectHeaders: { login: '你的RabbitMQ用户名', passcode: '你的RabbitMQ密码' }, onConnect: () => { // 监听用户消息投递回调 } }); rabbitStompClient.activate(); // 处理前端发送的聊天消息 async function handleChatMessage(msg, senderId) { const { toUserId, content, msgId } = JSON.parse(msg.body); // 消息落盘 await pg.query('INSERT INTO messages (id, from_uid, to_uid, content, created_at, status) VALUES ($1, $2, $3, $4, NOW(), 0)', [msgId, senderId, toUserId, content]); // 投递到目标用户的私有队列 rabbitStompClient.publish({ destination: `/user/${toUserId}/private_chat`, body: JSON.stringify({ fromUid: senderId, content, msgId, timestamp: Date.now() }) }); // 更新消息状态为已发送 await pg.query('UPDATE messages SET status = 1 WHERE id = $1', [msgId]); }
2. 前端实现
- 引入STOMP.js依赖,用户打开聊天窗口时先携带token向后端发起WebSocket连接请求
- 连接建立成功后,订阅自己的私有消息队列:
const stompClient = new StompJs.Client({ brokerURL: 'ws://你的后端地址/ws/chat', connectHeaders: { token: '当前用户登录凭证' } }); stompClient.onConnect = () => { // 订阅自己的私有消息队列 stompClient.subscribe(`/user/${currentUserId}/private_chat`, (msg) => { const message = JSON.parse(msg.body); // 渲染新消息到聊天窗口 }); }; stompClient.activate(); // 发送消息逻辑 function sendMessage(toUserId, content) { const msgId = generateUniqueId(); stompClient.publish({ destination: '/app/chat', body: JSON.stringify({ toUserId, content, msgId }) }); // 先渲染自己发送的消息到聊天窗口 }
- 用户关闭聊天窗口/离开页面时,主动调用
stompClient.deactivate()断开连接,释放资源
3. 历史/离线消息处理
- 用户打开聊天窗口时,先向后端发起请求拉取最近30天的历史消息,渲染完成后再建立WebSocket连接接收实时消息
- 可以在RabbitMQ中配置消息过期时间,超过24小时未被消费的消息会自动丢弃,用户上线时主动从PostgreSQL拉取离线期间的未读消息即可
可选优化点
- 新增消息ACK机制:接收方收到消息后返回已收通知,后端更新PostgreSQL中的消息状态,避免消息丢失
- 新增已读回执:接收方查看消息后发送已读通知,发送方可以实时看到消息已读状态
- 大体积内容(图片、文件)先上传到对象存储,消息体中只携带资源URL,减少STOMP消息体大小
内容的提问来源于stack exchange,提问作者Abinash Biswal
相关产品推荐
相关产品推荐

