发布确认与消息退回

区分客户端发送、服务端确认与无法路由时的消息退回,验证两种发布结果。

🎯 引言

支付系统发出一条消息,希望订单程序稍后处理。但发送过程中,网络可能断开,队列的接收规则也可能配置错误。发送方怎样知道消息有没有进入队列,而不是只看到自己打印了一句“已发送”?本篇介绍发布确认和消息退回,并用成功进入队列、没有队列接收两个实验,说明如何判断发送结果。


🧱 发送方需要检查两个结果

发布确认(publisher confirm)是 RabbitMQ 对生产者这次发布的答复。消费者是否完成订单处理,需要上一篇的消费确认,两者互不代替。

消息退回(return)用于通知发送方:消息无法路由到队列。本篇发布时开启 mandatory: true,要求在没有匹配队列时退回消息;未开启时,这种消息默认会被丢弃。

信号谁发给谁表示什么
发布确认RabbitMQ → 生产者服务端完成了这次发布的处理
消息退回RabbitMQ → 生产者这条 mandatory 消息没有可路由的队列
消费确认消费者 → RabbitMQ消费者报告这次投递处理完成

发布确认与消息退回可能同时发生。 服务端知道没有队列匹配,也算处理了这次发布,所以不能把“收到发布确认”直接当成“消息进入业务队列”。


🛠 准备一个只有 success 绑定的交换机

沿用安装与连接中的目录、依赖和 config.mjs。所有文件保存在同一目录,命令也在此执行。

setup-confirms.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.events', 'direct', { durable: false });
await channel.assertQueue('order.payment-success', { durable: false });
await channel.bindQueue('order.payment-success', 'payment.events', 'success');
console.log('发布确认实验已准备');
await channel.close();
await connection.close();

交换机 payment.events 表示支付事件,使用 Direct 类型;队列 order.payment-success 表示订单系统接收支付成功消息的队列,绑定键为 success。本篇使用非持久化资源,只观察发送结果,下一篇再讨论重启后的保留。

node setup-confirms.mjs

本实验不需要消费者在线。消息能进入队列,就可以等待之后的消费;服务端的发布确认不等待业务处理。


📤 等待确认并检查退回

publish-check.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

const routingKey = process.argv[2] ?? 'success';
const connection = await amqp.connect(rabbitmqUrl);
try {
    const channel = await connection.createConfirmChannel();
    let returned = false;
    channel.on('return', (message) => {
        returned = true;
        console.log('消息被退回', message.fields.routingKey, message.fields.replyText);
    });
    channel.publish('payment.events', routingKey, Buffer.from('P1001'), {
        mandatory: true,
    });
    await channel.waitForConfirms();
    console.log('已收到发布确认');
    if (returned) {
        console.log('发布结果:没有匹配队列');
        process.exitCode = 1;
    } else {
        console.log('发布结果:已路由到队列');
    }
} finally {
    await connection.close();
}

createConfirmChannel() 创建支持发布确认的通道,waitForConfirms() 等待此前提交的消息得到确认,服务端否定确认等失败会使等待抛错。finally 在流程结束后关闭连接。

return 监听必须在发布之前注册。对于本例无法路由的 mandatory 消息,服务端先发送退回,再发送发布确认,因此等待确认后可以检查 returned。每次运行只发一条,布尔变量足以表示结果;批量发送则需要把退回与具体消息对应。

publish() 返回的 true 或 false 表示客户端写入缓冲区是否允许继续写,不是服务端确认。返回 false 也不等于该消息已被拒绝,不能据此直接重发。接口见 amqplib 通道 API。


🔎 验证两种发布结果

先用已有绑定发送:

node publish-check.mjs success

预期输出:

已收到发布确认
发布结果:已路由到队列

再用没有绑定的路由键:

node publish-check.mjs unknown

在本例没有额外绑定的前提下,预期输出:

消息被退回 unknown NO_ROUTE
已收到发布确认
发布结果:没有匹配队列

第二次程序以非零状态退出,表示本次没有完成期望的入队目标。它演示的是“交换机存在但没有匹配队列”,不是向不存在的交换机发布;后者会引发通道错误。

第一种情况的消息仍保存在 order.payment-success 队列里。反复实验会增加待消费数量,本篇不需要清空队列来验证发布信号。


❓ 知识问答

Q1:没有收到确认,能认定消息没进去吗?

不能。消息可能已被接收,只是答复没有送达。重发应沿用业务编号,并让消费者防重复。

Q2:mandatory 能确认所有预期队列都收到吗?

不能。它检测没有任何队列可接收,不会核对你的完整订阅清单。

Q3:数据库已经写入,程序还没发消息就退出,发布确认能补救吗?

不能。它只覆盖已经提交的发布,不负责数据库操作与消息发布的一致性。确认的边界见 RabbitMQ 官方说明。


🧪 小练习

向 Success 发布一次,再向 success 发布一次。预期前者退回,后者入队,两次都能收到发布确认。解释为什么只检查确认日志不足以判断路由结果。


🎉 你已经能分别核对发布是否得到确认、消息是否因无法路由而被退回了!