Topic 交换机的通配符路由
🎯 引言
上一篇用 Direct 交换机精确匹配事件。随着支付事件增多,记账系统如果想接收所有支付事件,就要逐条添加绑定。Topic 交换机允许在绑定中使用通配符,用一条规则接收一组路由键。本篇通过支付消息实验,弄清规则写在哪里、* 与 # 如何匹配,以及最终哪些队列会收到消息。
🧱 消息写具体路由键,绑定写接收规则
先沿用上一篇的两个概念:路由键是发送方给消息附带的分发标记;绑定键是队列绑定到交换机时填写的接收条件。Topic 改变的是比较方式:绑定键可以用通配符表达一组符合条件的路由键。
例如,记账队列希望接收所有支付相关事件,设置绑定:
await channel.bindQueue('topic.accounting', 'payment.topic', 'payment.#');
三个参数依次是队列名、交换机名、绑定键。payment.# 写在绑定的接收条件里,这一步没有发送消息。
发送方发布一条具体的支付成功消息:
channel.publish('payment.topic', 'payment.success', body);
三个参数依次是交换机名、路由键、正文。body 代表消息的字节数据,后面的完整示例会创建它。
| 比较对象 | 填写位置 | 本例的值 |
|---|---|---|
| 队列绑定的接收规则 | bindQueue() 第三个参数 | payment.# |
| 消息携带的具体标记 | publish() 第二个参数 | payment.success |
交换机会判断:消息的 payment.success 是否符合绑定中的 payment.#? 符合才转发到该队列。通配符用于绑定规则,发送本例事件时填写具体路由键,不用 payment.# 代替所有支付事件。
🔎 点号分段后,星号和井号分别匹配什么
Topic 使用点号 . 分隔路由键中的各段。每一段都是一个字符串,不要求是某种内置业务名称:
| 路由键 | 分成的各段 | 总段数 |
|---|---|---|
payment | payment | 1 |
payment.success | payment、success | 2 |
payment.refund.completed | payment、refund、completed | 3 |
本例约定 payment 表示支付类别。RabbitMQ 只按这些文字匹配,不理解支付或退款的业务含义,也不解析正文来决定去向。
星号必须对应一段
绑定键 payment.* 可以拆成固定文字 payment 和通配符 *。第一段必须是 payment,后面必须恰好还有一段。
因此 payment.success 能匹配:payment 对应固定文字,success 对应星号。payment.refund.completed 不能匹配:payment 后还有 refund、completed 两段,一个星号放不下。payment 也不能匹配,因为星号不能省略那一段。
井号可以对应零段或多段
绑定键 payment.# 的第一段同样必须是 payment,但井号允许后面没有其他段,也允许有一段或多段。
所以 payment、payment.success、payment.refund.completed 都能匹配。特别注意 payment:井号对应零段时,不要求它以点号结尾。
把两条规则放在一起核对:
| 消息路由键 | 绑定键 payment.* | 绑定键 payment.# | 判断依据 |
|---|---|---|---|
payment | 不匹配 | 匹配 | payment 后面是零段 |
payment.success | 匹配 | 匹配 | 后面是一段 |
payment.refund | 匹配 | 匹配 | 后面是一段 |
payment.refund.completed | 不匹配 | 匹配 | 后面是两段 |
invoice.success | 不匹配 | 不匹配 | 固定的第一段不相同 |
这里数的是点号分隔的段数,不是字符数。通配符也不只能放在末尾,例如 *.success 可以匹配 payment.success 和 invoice.success,但不能匹配 payment.refund.success。匹配规则可参照 RabbitMQ 官方 Topic 教程。
🛠 建立两条规则并发送测试消息
沿用安装与连接的练习目录、amqplib 和 config.mjs。文件和命令都放在该目录下。以下只是路由观察实验,不会更新订单或写入账目。
为了同时观察两种规则,订单观察队列使用 payment.*,记账观察队列使用 payment.#。真实服务应按业务需要选择事件,本例的订单程序只打印结果。
创建交换机、队列和绑定
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
await channel.assertExchange('payment.topic', 'topic', { durable: false });
await channel.assertQueue('topic.order', { durable: false });
await channel.bindQueue('topic.order', 'payment.topic', 'payment.*');
await channel.assertQueue('topic.accounting', { durable: false });
await channel.bindQueue('topic.accounting', 'payment.topic', 'payment.#');
console.log('topic 规则已建立');
await channel.close();
await connection.close();
assertExchange() 的第一个参数 payment.topic 是交换机名称,第二个参数 topic 才是类型。队列名中的 topic 只是本篇的命名前缀,不参与匹配;真正的接收条件是两次 bindQueue() 的第三个参数。
durable: false 沿用基础篇的非持久化设置,本篇只观察路由。先执行:
node setup-topic.mjs
看到“topic 规则已建立”后再发送。队列和绑定必须提前存在,之后新建的绑定不会补收过去发布的消息。
发布五种具体路由键
用相同正文搭配五个不同路由键,覆盖刚才表格中的边界情况。payment 这条单段标记特意用于验证井号匹配零段,不是要求真实业务也这样命名事件。
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
const routingKeys = [
'payment',
'payment.success',
'payment.refund',
'payment.refund.completed',
'invoice.success',
];
const body = Buffer.from(JSON.stringify({ paymentId: 'P1001' }));
for (const routingKey of routingKeys) {
channel.publish('payment.topic', routingKey, body);
console.log('已发布', routingKey);
}
await channel.close();
await connection.close();
循环中的 routingKey 每次取列表中的一个具体值,作为 publish() 第二个参数。正文由支付编号对象转成 JSON 文字,再转成字节数据;正文内容不参与本次路由判断。
node publish-topic.mjs
匹配的消息现在等待在队列里,接下来启动消费者读取。
📥 从两个队列核对分发结果
订单观察程序:
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
await channel.consume('topic.order', (message) => {
if (message === null) return;
console.log(message.fields.routingKey);
}, { noAck: true });
console.log('order 等待消息');
记账观察程序:
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
await channel.consume('topic.accounting', (message) => {
if (message === null) return;
console.log(message.fields.routingKey);
}, { noAck: true });
console.log('accounting 等待消息');
consume() 指定从哪个队列读取,回调打印消息实际携带的 message.fields.routingKey。规则在交换机转发时已经应用,消费者无需再次匹配。noAck: true 简化本篇接收演示,业务处理完成后再确认的方式在后续章节介绍。
分别在两个终端启动:
node order-topic.mjs
node accounting-topic.mjs
除启动提示外,订单终端应收到两条,符合绑定键 payment.*:
payment.success
payment.refund
记账终端应收到四条,符合绑定键 payment.#:
payment
payment.success
payment.refund
payment.refund.completed
这次共发布五条消息,但两个队列合计收到六份:success 和 refund 两条消息同时匹配两个队列,各有两个副本;单段 payment 和三段 payment.refund.completed 只进入记账队列。invoice.success 没有匹配任何队列,在本例没有退回设置的情况下被丢弃。
Topic 会转发给所有匹配的队列,并不会只选择匹配得最具体的规则。 如果同一队列的多条绑定都匹配这次发布,该队列仍只收到一份;这不代表能自动消除生产者重复发布或后续重新投递的消息。
保持消费者运行,再发布一次,应分别新增两条与四条。如果以前做过本篇实验,先让旧消息处理完,停止多余的同队列消费者,并按练习后的步骤撤销额外绑定,再核对新增输出。
❓ 知识问答
Q1:payment.ref 能匹配所有 ref 开头的事件吗?*
不能。这里的通配符必须独立占一段,ref* 不是字符前缀匹配规则。要接收 payment 后面任意一段,使用 payment.*。
Q2:绑定键一定要有通配符吗?
不需要。绑定为 payment.success 时,只匹配相同的具体路由键。
Q3:payment.# 可以匹配 invoice.payment.success 吗?
不能。这个绑定要求开头是 payment,井号只能匹配它所在位置对应的剩余部分,不能跳过前面的 invoice。
🧪 小练习
保留订单队列原来的 payment.* 绑定,在准备脚本关闭通道前,再为 topic.order 添加一条到 payment.topic 的绑定,绑定键为 payment.*.*。
先预测结果,再重新执行准备和发送脚本。预期订单本次新增三条:payment.success、payment.refund、payment.refund.completed,仍没有单段 payment;记账仍新增四条。
其中 refund 和 completed 分别对应新增规则中的两个星号。旧的 payment.* 绑定依然存在,所以原来能收到的两条消息也仍会到达。
练习后恢复基本绑定
先从准备脚本删除新增绑定的代码,再运行下面的恢复脚本。只删代码或重新声明原有绑定,都不会自动撤销服务端已经建立的额外绑定。
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';
const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();
await channel.unbindQueue('topic.order', 'payment.topic', 'payment.*.*');
console.log('已撤销订单队列的 payment.*.* 绑定');
await channel.close();
await connection.close();
unbindQueue() 的三个参数与建立绑定时对应:队列名、交换机名、要撤销的绑定键。等练习消息处理完,保持两个消费者运行,再执行:
node reset-topic-binding.mjs
node publish-topic.mjs
预期订单恢复为新增两条,记账仍新增四条。解绑只影响后续发布,不会删除已经进入队列的消息。
🎉 你已经能逐段对照消息与绑定规则,判断 Topic 的分发结果了!
