消息处理与消费确认

通过中断消费者,观察未确认消息重新投递,并理解业务为什么仍要防重复。

🎯 引言

订单程序收到支付消息后,需要更新订单。如果程序刚收到就退出,这项工作还没有完成,消息却可能已经从队列移除。本文用手动消费确认解决这个问题:让 RabbitMQ 在处理完成之前,继续记住这条尚未完成的投递。


🧱 给“已经完成”一个明确的信号

前面的 noAck: true 表示不需要消费者另发确认,RabbitMQ 投递后就可以移除消息。它不会检查订单是否更新成功。

改为 noAck: false 后,收到的消息先处于未确认状态。消费者处理成功,再调用 ack(message),告诉 RabbitMQ 可以移除这次投递。这个动作叫消费确认。管理页面把等待投递的数量称为 Ready,把已投递但未确认的数量称为 Unacked;消息从等待到领取再到确认,对应 Ready 减少、Unacked 增加,再由 Unacked 减少。noAck 可以读成“不需要确认”:true 表示不需要消费者确认,false 才表示启用手动确认。

阶段消息状态消费者需要做什么
还没领取在队列中等待等待投递
已领取,业务未完成已投递但未确认完成业务,不提前 ack
业务成功等待服务端处理确认用收到消息的通道发送 ack

消费者连接断开后,服务端检测到断开才会重新安排未确认投递,不是按下 Ctrl+C 的瞬间就一定完成重入队。

如果处理期间连接断开,RabbitMQ 检测到断开后,会把尚未确认的消息重新放回队列,供消费者再次领取。只要连接还有效,短暂不确认并不意味着立刻重发;服务端也可能因确认超时关闭通道。


📤 准备一条订单任务

沿用安装与连接准备的练习目录、amqplib 和 config.mjs。所有文件保存在同一目录,命令也在该目录执行。示例只模拟业务,不会实际修改订单或发送通知。

使用独立的 work.order 队列。正文只放支付编号,每次换一个编号,便于区分新任务与重新投递的任务。

send-work.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();

await channel.assertQueue('work.order', { durable: false });
channel.sendToQueue('work.order', Buffer.from(process.argv[2] ?? 'P1001'));
console.log('已提交工作消息');
await channel.close();
await connection.close();

process.argv[2] 是命令中的编号,省略时使用 P1001。发送日志只说明客户端执行了发送操作,服务端接收结果将在下一篇用发布确认核对。这个队列是非持久化的,本篇只实验消费者退出,不实验 RabbitMQ 重启。


📥 模拟处理五秒,再确认

创建消费者:

worker.mjs
import { setTimeout as delay } from 'node:timers/promises';
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();

await channel.assertQueue('work.order', { durable: false });
await channel.prefetch(1);
await channel.consume('work.order', async (message) => {
    if (message === null) return;
    console.log(process.pid, '开始', message.content.toString(), '重新投递', message.fields.redelivered);
    await delay(5000);
    channel.ack(message);
    console.log(process.pid, '完成', message.content.toString());
}, { noAck: false });
console.log('等待工作消息');

delay(5000) 返回一个五秒后完成的等待,用它模拟更新订单的耗时。await 让确认发生在等待结束以后;实际业务应该先成功提交订单更新,再确认。

prefetch(1) 让这个消费者一次最多持有一条未确认消息,方便观察。process.pid 是进程编号;redelivered 是服务端提供的重新投递标记。标记用于观察,不代替业务去重。

ack() 必须通过收到该消息的同一通道调用,同一投递也不能重复确认。这里的“完成”日志说明模拟业务已经结束且调用了 ack,不是服务端另行回传的确认结果;刚打印就强行退出,确认仍可能未送达。


🛠 做一次中断实验

先让旧任务处理完,再停止其他 worker.mjs,每次实验使用一个未用过的编号。在终端一启动消费者:

node worker.mjs

终端二提交任务:

node send-work.mjs P1001

终端一出现“开始 P1001”后,在五秒内按 Ctrl+C 停止它。然后重新启动 worker.mjs。

预期再次看到 P1001,重新投递标记为 true;这次不打断,五秒后显示“完成 P1001”。让程序继续在线几秒,再停止并启动消费者,正常情况下不应再收到这次已确认的投递。若已经打印完成才按 Ctrl+C,就没有制造出未确认中断,需要换编号再试。


🪤 为什么确认以后仍要考虑重复业务

存在这样一个时间空隙:数据库已经更新成功,消费者还没来得及把确认送达,连接就断开了。消息可能再次投递,但前一次数据库操作确实发生过。

因此业务还需要幂等:同一项业务即使重复执行,最终效果仍与执行一次相同。例如支付流水用支付编号建立唯一约束;再次收到同一编号时核对已有结果,而不是再记一笔钱。去重记录和业务写入需要一起成功提交,不能先标记完成、再单独写业务。

消费确认解决“未完成投递怎样保留”,并不承诺业务只执行一次。有关重新投递的说明见 RabbitMQ 确认文档。


❓ 知识问答

Q1:先 ack,再更新订单,行不行?

不适合这个目标。更新失败时,消息已经被确认,RabbitMQ 无法据此补发。

Q2:业务抛异常就会自动确认失败吗?

不会。服务端不知道 JavaScript 异常的业务含义;程序要明确处理失败,后面的拒绝消息篇会介绍。


🧪 小练习

提交 P1002,等到完成后重启消费者;再提交 P1003,在处理期间停止并重启。验证只有后者因未确认而重新出现,并用自己的话解释原因。


🎉 你已经能用一次真实中断,验证消费确认的作用了!