消息队列 / 系统课时
交换机与绑定
交换机与绑定
交换机负责“按规则分发”,队列负责“保存并等待消费”。本篇用一个可运行的最小拓扑把交换机声明、队列绑定与路由键串起来,并通过实际收消息验证:消息最终进入哪个队列,是交换机类型、绑定键和发布时路由键共同作用的结果。
学习目标
- 说清交换机、队列、绑定和路由键各自承担的职责。
- 使用客户端声明交换机、队列并创建绑定。
- 根据绑定关系判断消息是否能进入目标队列,并定位常见声明错误。
路由关系不是交换机单独决定
生产者发布消息时只指定交换机和 routing_key,并不会直接指定普通业务队列。交换机根据自己的类型读取已有绑定,再决定把消息复制到哪些队列;队列本身不参与“选路”,只接收已经被路由过来的消息。
绑定可以理解为交换机到队列的一条路由规则。以 Direct 交换机为例,绑定键为 order.created,只有发布路由键也恰好是 order.created 时,这条绑定才匹配。一个交换机可以绑定多个队列,一个队列也可以通过多个绑定接收不同路由键。

建立一个最小绑定
下面示例使用 Python 的 Pika 客户端连接本机 RabbitMQ。运行前需要已经安装 pika,并确保 Broker 可访问;示例默认使用本机 5672 和 guest/guest,远程环境应改用实际账号。
import json
import os
import pika
HOST = os.getenv("RABBITMQ_HOST", "127.0.0.1")
PORT = int(os.getenv("RABBITMQ_PORT", "5672"))
EXCHANGE = "lesson.exchange"
QUEUE = "lesson.audit"
ROUTING_KEY = "order.created"
credentials = pika.PlainCredentials(
os.getenv("RABBITMQ_USER", "guest"),
os.getenv("RABBITMQ_PASSWORD", "guest"),
)
connection = pika.BlockingConnection(
pika.ConnectionParameters(host=HOST, port=PORT, credentials=credentials)
)
channel = connection.channel()
# 先声明拓扑,再创建 exchange -> queue 的绑定关系。
channel.exchange_declare(exchange=EXCHANGE, exchange_type="direct", durable=False)
channel.queue_declare(queue=QUEUE, durable=False)
channel.queue_purge(queue=QUEUE)
channel.queue_bind(queue=QUEUE, exchange=EXCHANGE, routing_key=ROUTING_KEY)
payload = {"orderId": "order-1001"}
channel.basic_publish(
exchange=EXCHANGE,
routing_key=ROUTING_KEY,
body=json.dumps(payload).encode("utf-8"),
)
print(f"binding: {EXCHANGE} --{ROUTING_KEY}--> {QUEUE}")
# basic_get 只用于演示验证,生产消费者通常使用 basic_consume。
method, _, body = channel.basic_get(queue=QUEUE, auto_ack=True)
print(f"received: {method.routing_key} {body.decode('utf-8')}")
channel.queue_delete(queue=QUEUE)
channel.exchange_delete(exchange=EXCHANGE)
connection.close()预期输出
binding: lesson.exchange --order.created--> lesson.audit
received: order.created {"orderId": "order-1001"}exchange_declare 创建或确认交换机属性,queue_declare 创建或确认队列,真正把两者连起来的是 queue_bind。发布时的 routing_key 只是消息携带的路由信息,只有与交换机规则和绑定共同匹配时,消息才会进入该队列。
声明与绑定的关键边界
RabbitMQ 的声明操作具有“属性必须一致”的约束。若同名交换机已经存在,再用不同的 type、durable 等参数声明,Broker 会关闭当前 Channel 并返回 PRECONDITION_FAILED;这不是重复声明失败,而是拓扑定义发生了冲突。
排查“消息没有进队列”时,先确认发布到的交换机名称,再确认交换机类型、绑定是否存在、绑定键与 routing_key 是否匹配。不要只盯着消费者,因为消息可能在到达队列之前就已经因无匹配路由而离开了正常投递链路。
显式交换机和绑定适合表达稳定、可观测的业务拓扑。只要把“交换机选择规则、绑定规则、发布路由键”三者分开检查,大多数路由问题都能快速定位。