Direct 交换机的精确路由

从队列的绑定条件和消息的路由标记出发,理解 Direct 交换机如何选择接收队列。

🎯 引言

支付系统会发出“支付成功”和“退款完成”两种事件。订单程序只需要前一种,退款程序只需要后一种。上一篇的 fanout 会向所有绑定队列转发,无法满足这种筛选需求。本篇用 Direct 交换机,让消息只进入接收条件匹配的队列。


🧱 交换机比较的两个值

要实现筛选,需要分别告诉交换机两件事:队列想接收什么消息,以及当前发送的是什么消息。

队列用绑定键声明接收条件

队列与交换机之间的连接关系叫绑定,建立这条关系时填写的条件叫绑定键(binding key)。例如:

await channel.bindQueue('direct.order', 'payment.direct', 'success');

三个参数依次是队列名、交换机名、绑定键。这行表示:把 direct.order 队列绑定到 payment.direct 交换机,接收条件设为 success。此时只是设置规则,还没有发送消息。

消息用路由键携带分发标记

发送方发布消息时提供的分发标记叫路由键(routing key)。例如:

channel.publish('payment.direct', 'success', body);

三个参数依次是交换机名、路由键、消息正文。这里的 body 代表正文的字节数据,完整示例会创建它。这行表示:向 payment.direct 发布一条消息,它携带的路由键是 success。

Direct 比较路由键与绑定键是否完全相同

上面两处 success 的值相同,角色不同:一处是绑定上的接收条件,另一处是消息上的分发标记。

比较对象在哪里填写本例的值
队列绑定的绑定键bindQueue() 第三个参数success
消息携带的路由键publish() 第二个参数success

Direct 交换机收到消息后,检查自己的绑定关系。消息的路由键是 success,订单队列的绑定键也是 success,两者完全一致,所以消息进入订单队列。

它比较的是这两个值,不是队列名称,也不是消息正文。 success 和 refund 是本例约定的事件标记,不是 RabbitMQ 内置的业务状态。


🧭 用两条绑定判断消息去向

本例建立以下关系:

队列在 payment.direct 上配置的绑定键
direct.ordersuccess
direct.refundrefund

现在分别发送两条消息:

消息携带的路由键与订单绑定键 success 比较与退款绑定键 refund 比较进入的队列
success相同不同direct.order
refund不同相同direct.refund

Direct 会把消息交给所有匹配的队列。 如果再给退款队列添加 success 绑定,两个队列都会收到支付成功消息。精确匹配不意味着一条消息只能进入一个队列;一个队列也可以通过多条绑定接收多种事件。

下面先运行表格中的两条基本绑定,最后通过练习验证多个队列同时匹配的情况。


🛠 创建资源并发送消息

沿用安装与连接准备的练习目录、amqplib 和 config.mjs。下面的文件都放在这个目录,命令也在该目录执行。示例只打印消息,不实际更新订单或执行退款。

创建交换机和队列

交换机命名为 payment.direct,类型为 direct,把名称与类型区分开。队列保留本篇专用名称 direct.order、direct.refund,避免与其他章节混用;名称中的点号和 direct 只是命名约定,不参与匹配。

setup-direct.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.direct', 'direct', { durable: false });
await channel.assertQueue('direct.order', { durable: false });
await channel.assertQueue('direct.refund', { durable: false });
await channel.bindQueue('direct.order', 'payment.direct', 'success');
await channel.bindQueue('direct.refund', 'payment.direct', 'refund');
console.log('direct 规则已建立');
await channel.close();
await connection.close();

assertExchange() 声明交换机,第一个参数是名称,第二个是类型。assertQueue() 声明队列。资源不存在时创建,已存在时核对配置,不能借此把同名 fanout 交换机改为 direct。

durable: false 沿用基础实验的非持久化设置,本篇不验证服务重启后的保留。先执行准备脚本:

node setup-direct.mjs

看到“direct 规则已建立”后,两个队列及绑定已经准备好。绑定只影响之后的发布,不会补收建立前的消息。

发布两种事件

创建下面的发送文件。两条消息使用相同正文,只改变路由键,便于观察分发依据:

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

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

const body = Buffer.from(JSON.stringify({ paymentId: 'P1001' }));
channel.publish('payment.direct', 'success', body);
channel.publish('payment.direct', 'refund', body);
console.log('已发布 success 和 refund');
await channel.close();
await connection.close();

JSON.stringify() 将支付编号对象转成文字,Buffer.from() 再将文字转成要发送的字节数据。这里没有把 success 或 refund 写进正文,它们分别放在两次 publish() 的第二个参数中。

node publish-route.mjs

此时尚未启动消费者,消息会等待在匹配的队列里。消费者可以稍后启动,前提是队列和绑定在发送之前已经存在。


📥 分别读取队列并核对结果

订单消费者

order-success.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

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

await channel.consume('direct.order', (message) => {
    if (message === null) return;
    const event = JSON.parse(message.content.toString());
    console.log('direct.order', message.fields.routingKey, JSON.stringify(event));
}, { noAck: true });
console.log('direct.order 等待消息');

退款消费者

refund.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

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

await channel.consume('direct.refund', (message) => {
    if (message === null) return;
    const event = JSON.parse(message.content.toString());
    console.log('direct.refund', message.fields.routingKey, JSON.stringify(event));
}, { noAck: true });
console.log('direct.refund 等待消息');

consume() 第一个参数指定读取哪个队列。消息到达后执行回调,message.fields.routingKey 是它发布时携带的路由键,message.content 是正文。两个消费者不需要再判断接收哪种事件,因为交换机已经在入队之前完成匹配。

noAck: true 表示服务端不等待消费者报告处理完成,本篇用它简化收发;后面的消费确认篇会介绍业务处理完成后再确认的方式。

打开两个终端,分别执行:

node order-success.mjs
node refund.mjs

除启动提示外,订单终端应收到:

direct.order success {"paymentId":"P1001"}

退款终端应收到:

direct.refund refund {"paymentId":"P1001"}

回看两条绑定:订单的 success 命中了第一条消息,退款的 refund 命中了第二条消息。保持两个消费者运行,在第三个终端再次执行 node publish-route.mjs,各终端应再新增一条对应输出。

如果之前运行过本篇实验,队列可能有旧消息,绑定也可能被练习修改。先处理完旧消息、停止多余的同队列消费者,并按下文恢复基本绑定,再核对本次新增输出。


❓ 知识问答

Q1:success 到底是绑定键还是路由键?

取决于它放在哪里。在 bindQueue() 第三个参数里,它是绑定键的值;在 publish() 第二个参数里,它是路由键的值。Direct 要比较的正是这两个位置上的值。

Q2:正文写了 refund,但路由键是 success,会去哪里?

按当前基本绑定进入订单队列。Direct 不解析正文来决定去向,因此发送方必须正确填写路由键。

Q3:把路由键写成 Success 会怎样?

它与 success 不完全相同,不会命中该绑定。本例没有其他匹配绑定,也未设置消息退回机制,因此这条消息会被丢弃,不会留给未来建立的绑定。


🧪 小练习

让退款队列同时接收成功和退款事件。在 setup-direct.mjs 关闭通道之前,自己补写一次 bindQueue():队列仍为 direct.refund,交换机仍为 payment.direct,新增绑定键为 success。

重新执行准备脚本,再执行发送脚本。预期订单终端新增一条 success,退款终端新增 success、refund 各一条。解释为什么同一条 success 消息会进入两个队列。

练习后恢复基本绑定

先从准备脚本删除刚加的绑定语句,避免下次运行又把它加回来。只删代码不会撤销已经存在的绑定,重新运行原准备脚本也不会自动清理额外绑定。

创建恢复脚本,通过 unbindQueue() 撤销指定绑定。它的三个参数与建立绑定时对应:队列、交换机、绑定键。

reset-direct-binding.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

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

await channel.unbindQueue('direct.refund', 'payment.direct', 'success');
console.log('已撤销退款队列的 success 绑定');
await channel.close();
await connection.close();
node reset-direct-binding.mjs
node publish-route.mjs

保持两个消费者运行,先等练习中的消息处理完,再执行这两条命令。预期本次订单只新增 success,退款只新增 refund。撤销绑定影响后续发布,不会删除已经进入队列的消息。


🎉 现在你可以把消息的路由键与队列的绑定键逐一比较,判断 Direct 的分发结果了!