队列与消息持久化
🎯 引言
支付消息已经进入队列,订单程序还没来得及处理,RabbitMQ 就需要重启维护。服务恢复后,订单程序还能收到这条消息吗?本篇介绍队列和消息各自需要的持久化设置,再用“先发送、重启服务、最后接收”的实验验证结果。
🧱 保留队列,不等于保留其中所有消息
持久化是把需要保留的内容保存到磁盘等存储中,让程序重启后能够恢复。这里需要区分两个对象:队列本身,以及队列中等待处理的消息。
| 对象 | 设置位置 | 重启后要保留的内容 |
|---|---|---|
| 队列 | assertQueue() 的 durable: true | 队列名称及配置,也就是队列定义 |
| 消息 | publish() 的 persistent: true | 这条尚未消费的消息内容与属性 |
| 交换机 | assertExchange() 的 durable: true | 交换机名称、类型等定义,便于继续发布 |
本例需要持久化队列接收持久化消息。 队列的 durable 不会自动为每条消息设置 persistent;消息的 persistent 也不能让非持久化队列在重启后恢复。
交换机的 durable 保留路由入口,不负责保存消息正文。本例的交换机和队列都持久化,它们之间的绑定也会恢复。相关说明见 RabbitMQ 队列文档。
🛠 建立支付交换机和订单队列
沿用安装与连接准备的练习目录、依赖和连接配置。
本例使用支付完成交换机 payment.completed 和订单处理队列 order.fulfillment。采用新名称,避免与前面非持久化资源的配置冲突。
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
await channel.assertExchange('payment.completed', 'direct', { durable: true });
await channel.assertQueue('order.fulfillment', { durable: true });
await channel.bindQueue('order.fulfillment', 'payment.completed', 'success');
console.log('支付交换机与订单处理队列已建立');
await channel.close();
await connection.close();
node setup-durable.mjs
📤 发送后等待保存完成
设置 persistent 是提出保存要求,还需要等待服务端完成保存。本例沿用上一篇的发布确认与退回检查,新增 persistent: true。对进入持久化队列的持久化消息,发布确认会等待相应持久化条件满足,详见 官方确认文档。
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const paymentId = process.argv[2] ?? 'P7001';
const connection = await amqp.connect(rabbitmqUrl);
try {
const channel = await connection.createConfirmChannel();
let returned = false;
channel.on('return', (message) => {
returned = true;
console.error('消息被退回', message.fields.replyText);
});
channel.publish('payment.completed', 'success', Buffer.from(paymentId), {
persistent: true,
mandatory: true,
});
await channel.waitForConfirms();
if (returned) throw new Error('没有队列接收这条消息');
console.log('RabbitMQ 已确认接收', paymentId);
} finally {
await connection.close();
}
先停止订阅 order.fulfillment 的消费者,让消息留在队列中。发送时传入本次支付编号;重复实验换用新编号,避免与旧消息混淆:
node publish-confirmed.mjs P7001
预期输出:
RabbitMQ 已确认接收 P7001
收到这条确认且程序正常退出后,再进行重启;发送失败时先排查原因。
🔄 重启 RabbitMQ,再读取这条消息
保留原来的存储
使用环境篇的容器和数据卷 rabbitmq-course-data,只重启,不删除或更换存储。数据卷提供保存文件的位置,不能代替 durable 和 persistent 的设置。
docker restart rabbitmq-course
docker exec rabbitmq-course rabbitmq-diagnostics -q ping
如果节点尚未恢复,稍后重新执行检查。出现 Ping succeeded 后,再确认客户端连接可用:
node check.mjs
看到“连接成功”后直接接收。不要重新执行 setup-durable.mjs,也不要补发消息。 这样才能验证恢复的是重启前的队列和消息。
只订阅已经恢复的队列
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
await channel.consume('order.fulfillment', (message) => {
if (message === null) return;
console.log('收到', message.content.toString());
channel.ack(message);
}, { noAck: false });
console.log('等待订单处理消息');
接收程序只订阅已有队列,打印编号后确认,不实际更新订单数据。
node receive-saved.mjs
除启动提示外,应看到:
收到 P7001
读到本次编号,说明消息在这次重启后保留了下来。让消费者保持在线,等待确认被服务端处理;已确认移除的消息不会在下次重启时恢复,持久化不是历史消息归档。
重启也会断开其他示例的连接,前面的非持久化资源可能消失。回到那些章节时,重新准备对应资源并启动消费者;课程脚本未实现自动重连。
❓ 知识问答
Q1:正常重启实验通过,就能保证任何故障都不丢消息吗?
不能。本篇只验证保留原存储的正常重启,不覆盖磁盘损坏、删除数据卷等情况。
Q2:把 persistent 改成 false,就一定能观察到消息在重启后消失吗?
不应把缺少持久化保证理解成每次实验都必然丢失。应按队列类型和官方保证配置,不能靠某一次观察判断可靠性。
🧪 小练习
让本次消息处理完,再停止接收程序。先预测结果,然后发送两条不同编号的消息:
node publish-confirmed.mjs P7002
node publish-confirmed.mjs P7003
等两次都收到发布确认后,重启服务,完成健康和连接检查,直接运行接收程序。预期读到 P7002、P7003。
说明队列的 durable、消息的 persistent 和发送方等待发布确认分别负责什么。
🎉 你已经能分别配置队列与消息的持久化,并用重启后的接收结果验证它们!
