消息队列 / 系统课时
发布第一条消息
发布第一条消息
本节完成一个最小可运行的 Java 发布程序:连接本地 RabbitMQ,创建信道和队列,再通过默认交换机发送一条文本消息,并理解空交换机名与 routing key 的真实含义。
学习目标
- 使用 Java 客户端创建
Connection与Channel - 通过默认交换机向指定队列发布消息
- 判断消息没有进入目标队列时应先检查什么
建立连接并完成一次发布
以下示例假设 RabbitMQ 正运行在本机 5672 端口,工程已经引入 com.rabbitmq:amqp-client。程序先声明一个持久化队列,确保路由目标存在,再把 UTF-8 文本发送到默认交换机。
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import java.nio.charset.StandardCharsets;
public class PublishOnce {
private static final String QUEUE = "hello.queue";
public static void main(String[] args) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
factory.setPort(5672);
factory.setUsername("guest");
factory.setPassword("guest");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
// 先声明队列,避免默认交换机找不到同名路由目标。
channel.queueDeclare(QUEUE, true, false, false, null);
String message = "hello rabbitmq";
channel.basicPublish(
"",
QUEUE,
null,
message.getBytes(StandardCharsets.UTF_8)
);
System.out.println("published: " + message);
}
}
}预期输出
published: hello rabbitmq这行输出只说明客户端已经执行完 basicPublish 调用;它不是发布确认,也不能单独证明消息已经持久化到磁盘。发布确认属于可靠性控制,需要另外启用 publisher confirms。

读懂默认交换机的路由
RabbitMQ 的默认交换机名称就是空字符串 ""。队列创建后会自动以自己的队列名作为 routing key 绑定到默认交换机,所以示例中的 QUEUE 同时也是 basicPublish 的第二个参数。
如果 hello.queue 不存在,而发布时又没有设置 mandatory 返回机制,那么这条消息不会凭空创建队列。示例把 queueDeclare 放在发布之前,就是为了让第一次运行也具备完整的路由条件。
连接、信道与发布调用各自做什么
Connection 是客户端与 Broker 之间的 TCP 连接,创建成本较高;Channel 是复用在连接上的轻量逻辑会话,通常用于声明拓扑和收发消息。一次应用进程一般复用连接,并按线程或工作单元使用信道,而不是每发一条消息都重新建 TCP 连接。
basicPublish 的关键参数只有三层含义:发到哪个交换机、使用什么 routing key、携带什么消息体。本例不设置消息属性,是为了只聚焦最小发布链路;以后需要持久化、内容类型或追踪信息时,再通过 BasicProperties 补充。
消息没有到队列时先检查什么
先确认队列名与 routing key 是否完全一致,再确认发布目标是否真的是默认交换机 ""。随后检查连接所使用的虚拟主机、账号权限和目标队列是否存在;同名队列位于不同 vhost 时彼此完全隔离。
完成这个程序后,发布链路可以归纳为:Java 客户端在 Connection 上创建 Channel,默认交换机根据 routing key 找到同名队列,然后把消息交给队列保存,等待消费者读取。