You need to enable JavaScript to run this app. 如何在JavaScript中使用RabbitMQ与STOMP WebSocket实现实时一对一聊天功能
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 17:36:02