队列与消息持久化

分清队列与消息各自的保存设置,让尚未处理的支付消息在 RabbitMQ 重启后仍能被读取。

🎯 引言

支付消息已经进入队列,订单程序还没来得及处理,RabbitMQ 就需要重启维护。服务恢复后,订单程序还能收到这条消息吗?本篇介绍队列和消息各自需要的持久化设置,再用“先发送、重启服务、最后接收”的实验验证结果。


🧱 保留队列,不等于保留其中所有消息

持久化是把需要保留的内容保存到磁盘等存储中,让程序重启后能够恢复。这里需要区分两个对象:队列本身,以及队列中等待处理的消息。

对象设置位置重启后要保留的内容
队列assertQueue() 的 durable: true队列名称及配置,也就是队列定义
消息publish() 的 persistent: true这条尚未消费的消息内容与属性
交换机assertExchange() 的 durable: true交换机名称、类型等定义,便于继续发布

本例需要持久化队列接收持久化消息。 队列的 durable 不会自动为每条消息设置 persistent;消息的 persistent 也不能让非持久化队列在重启后恢复。

交换机的 durable 保留路由入口,不负责保存消息正文。本例的交换机和队列都持久化,它们之间的绑定也会恢复。相关说明见 RabbitMQ 队列文档。


🛠 建立支付交换机和订单队列

沿用安装与连接准备的练习目录、依赖和连接配置。

本例使用支付完成交换机 payment.completed 和订单处理队列 order.fulfillment。采用新名称,避免与前面非持久化资源的配置冲突。

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.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
如果已有同名资源使用 durable: false,再用 true 声明会报配置不一致,不能原地修改。不要为完成实验随意删除含有业务消息的队列。

📤 发送后等待保存完成

设置 persistent 是提出保存要求,还需要等待服务端完成保存。本例沿用上一篇的发布确认与退回检查,新增 persistent: true。对进入持久化队列的持久化消息,发布确认会等待相应持久化条件满足,详见 官方确认文档。

publish-confirmed.mjs
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,也不要补发消息。 这样才能验证恢复的是重启前的队列和消息。

只订阅已经恢复的队列

receive-saved.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 和发送方等待发布确认分别负责什么。


🎉 你已经能分别配置队列与消息的持久化,并用重启后的接收结果验证它们!