消息队列 / 系统课时

生产者发布消息时发生了什么

生产者发布消息时发生了什么

生产者调用发布 API 时,并不是把消息直接塞进某个队列,而是把交换机名、Routing Key、属性和消息体交给 RabbitMQ。理解这条链路后,才能判断“发布成功”与“真正路由到队列”是不是一回事。

学习目标

  • 说清一次 basic.publish 从生产者到交换机、绑定和队列的关键步骤
  • 理解交换机类型、Routing Key 与 Binding 如何共同决定路由结果
  • 使用 mandatory 检测“交换机存在但没有任何队列匹配”的情况

一次发布包含哪些信息

在 AMQP 0-9-1 模型里,生产者发布时至少要确定目标交换机、Routing Key 和消息体,也可以同时附带消息属性。RabbitMQ 收到发布请求后先定位交换机,再由交换机按自身类型和 Binding 规则计算应进入哪些队列;生产者通常不直接选择最终队列。

如果指定的交换机不存在,发布会触发通道级错误;如果交换机存在但没有队列匹配,结果取决于发布时的 mandatory 标志以及交换机是否配置了 Alternate Exchange。mandatory=false 时,无匹配消息通常不会返回给生产者;mandatory=true 时,RabbitMQ 会通过 basic.return 把不可路由消息退回。([RabbitMQ][1])

路由发生在哪一步

以 direct exchange 为例,交换机会比较消息的 Routing Key 与每条 Binding Key。完全匹配的绑定会把消息复制到对应队列;可以匹配多个队列,也可能一个都匹配不到。消费者是否在线不是 direct exchange 判断绑定是否匹配的条件,消息先被路由到队列,再由队列负责后续投递。

RabbitMQ 发布消息后的路由与未路由分支

用一个可运行示例观察路由结果

下面程序假设项目已经引入 RabbitMQ Java Client,并且本机 RabbitMQ 可通过 localhost:5672 使用默认访客账号连接。程序先声明 direct exchange 和临时队列,用可匹配的 Routing Key 发布一条消息,再用不存在的 Routing Key 发布第二条消息并开启 mandatory。

java
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.GetResponse;

import java.nio.charset.StandardCharsets;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicReference;

public class PublishRoutingDemo {
    public static void main(String[] args) throws Exception {
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost");

        try (Connection connection = factory.newConnection();
             Channel channel = connection.createChannel()) {

            String exchange = "demo.orders";
            channel.exchangeDeclare(exchange, BuiltinExchangeType.DIRECT, false);

            // 服务器生成独占临时队列,避免示例留下队列资源。
            String queue = channel.queueDeclare().getQueue();
            channel.queueBind(queue, exchange, "order.created");

            channel.basicPublish(
                    exchange,
                    "order.created",
                    null,
                    "order-1001".getBytes(StandardCharsets.UTF_8));

            GetResponse routed = channel.basicGet(queue, true);
            if (routed == null) {
                throw new IllegalStateException("可路由消息没有进入队列");
            }
            System.out.println("队列收到: "
                    + new String(routed.getBody(), StandardCharsets.UTF_8));

            CountDownLatch returned = new CountDownLatch(1);
            AtomicReference<String> returnResult = new AtomicReference<>();

            channel.addReturnListener(message -> {
                returnResult.set(message.getRoutingKey()
                        + " -> " + message.getReplyText());
                returned.countDown();
            });

            // mandatory=true:没有队列匹配时,要求 Broker 返回消息。
            channel.basicPublish(
                    exchange,
                    "order.unknown",
                    true,
                    null,
                    "order-1002".getBytes(StandardCharsets.UTF_8));

            if (!returned.await(3, TimeUnit.SECONDS)) {
                throw new IllegalStateException("未收到 basic.return");
            }
            System.out.println("未路由返回: " + returnResult.get());

            channel.exchangeDelete(exchange);
        }
    }
}

预期输出

text
队列收到: order-1001
未路由返回: order.unknown -> NO_ROUTE

这里的 NO_ROUTE 表示交换机存在,但没有任何绑定能接住 order.unknown。若连接地址、账号或虚拟主机不同,需要相应修改连接配置;这些差异不会改变路由判断过程。

不要把发布成功等同于已入队

basicPublish 调用能够发出消息,不等于生产者已经知道消息进入了目标队列。Publisher Confirm 用来确认 Broker 是否接收并处理了发布,而 mandatory 与 returned message 用来发现“已到交换机但没有队列匹配”的结果,两者回答的是不同问题。([RabbitMQ][2])

在需要可靠发布的业务里,通常应把“Broker 是否确认发布”和“消息是否至少路由到一个队列”分别设计和监控;只看一次 API 调用没有抛异常,无法覆盖这两个判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

生产者发布消息时发生了什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通