消息队列 / 系统课时
生产者发布消息时发生了什么
生产者发布消息时发生了什么
生产者调用发布 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 Java Client,并且本机 RabbitMQ 可通过 localhost:5672 使用默认访客账号连接。程序先声明 direct exchange 和临时队列,用可匹配的 Routing Key 发布一条消息,再用不存在的 Routing Key 发布第二条消息并开启 mandatory。
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);
}
}
}预期输出
队列收到: order-1001
未路由返回: order.unknown -> NO_ROUTE这里的 NO_ROUTE 表示交换机存在,但没有任何绑定能接住 order.unknown。若连接地址、账号或虚拟主机不同,需要相应修改连接配置;这些差异不会改变路由判断过程。
不要把发布成功等同于已入队
basicPublish 调用能够发出消息,不等于生产者已经知道消息进入了目标队列。Publisher Confirm 用来确认 Broker 是否接收并处理了发布,而 mandatory 与 returned message 用来发现“已到交换机但没有队列匹配”的结果,两者回答的是不同问题。([RabbitMQ][2])
在需要可靠发布的业务里,通常应把“Broker 是否确认发布”和“消息是否至少路由到一个队列”分别设计和监控;只看一次 API 调用没有抛异常,无法覆盖这两个判断。