架构与系统设计 / 系统课时
用 RabbitMQ 跑通消息路由
用 RabbitMQ 跑通消息路由
你将把订单确认事件同时送到计费和审计队列,把取消事件只送到审计队列,并让没有匹配规则的事件明确退回。通过一次可重复的实验,区分交换机负责路由、队列负责承接消息,以及消费者实际从哪里取消息。
学习目标
- 区分 Exchange、Queue、Binding 与 Routing Key 的职责。
- 使用 direct 交换机验证单队列匹配和多队列匹配。
- 识别未路由消息,并区分发布确认与消费确认。
先确定匹配规则,而不是先写消费者
本课使用 direct 交换机 eda.orders。生产者把消息连同 Routing Key 发给交换机,Binding 把队列和交换机关联起来;只有 Binding Key 与 Routing Key 完全相等的队列才匹配。([RabbitMQ][5])
同一个 Key 可以绑定多个队列,因此 direct 不等于“只发给一个队列”。计费和审计需要各自获得确认事件,就使用两个队列;它们不是同一队列里的两个竞争消费者。([RabbitMQ][5])
| Routing Key | eda.billing |
eda.audit |
|---|---|---|
order.confirmed |
接收 | 接收 |
order.cancelled |
不接收 | 接收 |
order.unknown |
不接收 | 不接收 |
这张表就是本次实验的验收标准。消息正文使用 JSON,但本例的匹配依据是发布参数 routing_key,不是正文里的 type 字段;两者由程序显式设置。

准备节点与隔离的 Python 依赖
准备已运行的 Docker、Python 3.11 或更高版本以及 venv 模块,在 Bash 中操作。实验固定使用 rabbitmq:4.3.6 和 pika==1.4.4;Windows 可使用已配置 Docker 集成的 WSL2。([Docker Hub][6])
在一个新的实验目录执行下列命令,确保不存在同名容器,且宿主机 5672 端口未被占用。账号密码仅供本地实验,端口只绑定回环地址;不需要管理插件或浏览器界面。
(
set -e
# 隔离客户端依赖,后续始终使用该环境的 Python。
python3 -m venv .venv
.venv/bin/python -m pip install --quiet pika==1.4.4
.venv/bin/python -c "import pika; print('pika=' + pika.__version__)"
# 仅向本机开放 AMQP;实验凭据不可复用于生产。
docker run -d --name eda-rabbit --hostname eda-rabbit \
-p 127.0.0.1:5672:5672 \
-e RABBITMQ_DEFAULT_USER=lab \
-e RABBITMQ_DEFAULT_PASS=lab-only-pass \
rabbitmq:4.3.6
ready=0
for attempt in {1..30}; do
if docker exec eda-rabbit rabbitmq-diagnostics -q -t 5 \
check_port_listener 5672 >/dev/null 2>&1; then
ready=1
break
fi
sleep 2
done
# 不把容器运行状态直接当作 AMQP 已经就绪。
if [ "$ready" -ne 1 ]; then
docker logs --tail 40 eda-rabbit
exit 1
fi
echo "RabbitMQ listener ready"
)预期输出,省略镜像下载进度及安装工具的提示:
pika=1.4.4
<ID>
RabbitMQ listener ready<ID> 是实际容器标识,每次可能不同。check_port_listener 只验证指定端口存在监听,不验证账号或消息处理能力;后面的客户端程序才完成认证、声明和投递验证。([RabbitMQ][7])
用一个脚本验证匹配、复制与退回
把下面完整程序保存为 route_demo.py,在同一目录使用 .venv/bin/python route_demo.py 运行。脚本先创建绑定,再发布消息,最后依次读取两个队列;所有路由由真实 RabbitMQ 完成,客户端角色只是合并在一个进程内演示。
程序使用 confirm_delivery() 配合 mandatory=True:没有匹配队列时,Pika 的阻塞接口会报告 UnroutableError。普通确认成功不等于消费者已经执行业务,不能把打印“发布完成”当成业务完成。([Pika][8])
import json
import pika
def main() -> None:
connection = pika.BlockingConnection(pika.ConnectionParameters(
host="127.0.0.1",
port=5672,
credentials=pika.PlainCredentials("lab", "lab-only-pass"),
connection_attempts=5,
retry_delay=2,
socket_timeout=5,
blocked_connection_timeout=10,
))
try:
channel = connection.channel()
channel.exchange_declare(exchange="eda.orders", exchange_type="direct")
bindings = {
"eda.billing": ["order.confirmed"],
"eda.audit": ["order.confirmed", "order.cancelled"],
}
# 先建立完整路由;独占队列随本连接关闭而删除。
for queue, keys in bindings.items():
channel.queue_declare(queue=queue, exclusive=True)
for key in keys:
channel.queue_bind(
queue=queue, exchange="eda.orders", routing_key=key
)
channel.confirm_delivery()
events = {
"order.confirmed": "OrderConfirmed",
"order.cancelled": "OrderCancelled",
"order.unknown": "UnknownEvent",
}
for key, event_type in events.items():
body = json.dumps({
"type": event_type, "orderId": "order-demo-1"
}).encode("utf-8")
try:
channel.basic_publish(
exchange="eda.orders", routing_key=key, body=body,
properties=pika.BasicProperties(content_type="application/json"),
mandatory=True,
)
except pika.exceptions.UnroutableError:
# 只把预设的未知路由视为正常测试结果。
if key != "order.unknown":
raise
print(f"UNROUTABLE {key}")
else:
if key == "order.unknown":
raise RuntimeError("未知路由意外匹配了队列")
print(f"PUBLISHED {key}")
# 有限实验用 basic_get 取空队列,并验证实际收到的路由。
for queue, expected in bindings.items():
received = []
while True:
method, _, body = channel.basic_get(queue=queue, auto_ack=False)
if method is None:
break
event = json.loads(body)
received.append(method.routing_key)
print(f"{queue} <- {method.routing_key}: {event['type']}")
# 本例以解析和输出模拟处理,处理成功后才确认。
channel.basic_ack(delivery_tag=method.delivery_tag)
if received != expected:
raise RuntimeError(f"{queue} 路由结果不符: {received}")
print("ROUTING OK")
finally:
if connection.is_open:
connection.close()
if __name__ == "__main__":
main()预期输出:
PUBLISHED order.confirmed
PUBLISHED order.cancelled
UNROUTABLE order.unknown
eda.billing <- order.confirmed: OrderConfirmed
eda.audit <- order.confirmed: OrderConfirmed
eda.audit <- order.cancelled: OrderCancelled
ROUTING OK确认事件只发布一次,却分别在两个队列出现;取消事件只在审计队列出现。ROUTING OK 来自程序对实际路由列表的检查,不只是无条件打印,少收、错收或未知路由意外匹配都会使实验失败。
把路由成功与可靠处理分开
发布确认关注生产者到 Broker,消费确认关注 Broker 到消费者。本例收到消息后调用 basic_ack(),代表这个消费者确认处理完成;两个队列中各自的投递需要各自确认,计费队列的确认不会替审计队列确认。([RabbitMQ][9])
本课没有配置备用交换机。order.unknown 的退回说明没有匹配队列,不是“消费者暂时没上线”。绑定必须在发布之前存在;不能把交换机当成等待未来补上 Binding 的消息仓库。([RabbitMQ][5])
为避免重复实验混入旧数据,队列设置为 exclusive=True,连接关闭时会被删除,所以请串行运行脚本。这是可丢弃的路由实验,并未验证持久化、进程崩溃后的恢复或重试策略。([RabbitMQ][10])
basic_get() 是这里用于逐条验收的同步取消息接口,队列为空时会返回空结果;本程序随后退出,而不是保持订阅等待新事件。持续消费需要使用订阅接口,并另行设计处理失败和确认策略。([Pika][8])
按连接、声明、匹配的顺序排错
连接失败时,先核对本课固定的地址、端口和账号。声明失败时,检查是否复用了旧对象:同名队列或交换机的属性不兼容会导致声明异常,不应通过忽略异常继续发布。([RabbitMQ][10])
能连接但没有预期投递时,逐字比较 exchange、queue_bind() 的 routing_key 和 basic_publish() 的 routing_key。本例使用 direct 精确匹配,大小写差异或拼写错误都不会自动纠正。([RabbitMQ][5])
完成后可以清理这个一次性节点。下面的命令删除本课容器及其匿名卷,不要用于需要保留数据的 RabbitMQ 环境。
# 只清理本课的临时实例,不影响其他消息节点。
docker rm -f -v eda-rabbit预期输出:
eda-rabbit路由实验的验收重点是三种结果均符合规则:匹配一个队列、匹配多个队列,以及无匹配时明确返回失败。