单片机与物联网 / 系统课时
理解 MQTT 模型
理解 MQTT 模型
MQTT 的关键不是“ESP32 怎样连服务器”,而是把设备从点对点通信改造成由 Broker 中转的发布订阅系统。本节从 Broker、主题、QoS 与保留消息四个核心概念出发,并用一组命令验证消息如何被路由给后来订阅的客户端。
学习目标
- 说清 Publisher、Broker、Subscriber 之间的职责边界
- 用主题和通配符组织设备消息,而不是依赖客户端地址
- 根据消息重要性选择 QoS,并理解 Retained Message 的用途
从客户端直连改成 Broker 中转
MQTT 客户端先与 Broker 建立连接。发布者把消息发送到某个 Topic,Broker 再根据订阅关系把消息转发给匹配的订阅者。发布者因此不需要知道消费者的 IP、数量或是否是网页、云服务还是另一块 ESP32。

这种解耦是 MQTT 最重要的心智模型:Broker 管路由,Topic 表达消息归属,客户端只负责发布或订阅。 同一个客户端也可以同时扮演发布者和订阅者。
用主题表达消息归属
Topic 是分层字符串,例如 factory/esp32-01/status。发布消息时必须给出具体 Topic;订阅时可以使用 Topic Filter。+ 匹配一个层级,例如 factory/+/status,# 匹配后续多个层级,例如 factory/#。
主题设计应体现“业务对象和消息类型”,而不是把动态值塞进大量随意层级。常见做法是固定前缀,再放设备 ID 和用途,例如 devices/<ID>/telemetry、devices/<ID>/status、devices/<ID>/commands。这里的 <ID> 是实际设备标识的占位符。
选择 QoS 与保留消息
QoS 描述 MQTT 在一段客户端与 Broker 链路上的交付语义,不等同于业务系统最终一定执行一次。
| QoS | 交付语义 | 典型用途 |
|---|---|---|
| 0 | 至多一次 | 高频、允许偶尔丢失的遥测 |
| 1 | 至少一次,可能重复 | 状态上报、普通控制消息 |
| 2 | 恰好一次,握手开销最高 | 少量、确需协议级去重的消息 |
QoS 1 可能发生重复投递,因此消费端仍应为有副作用的业务设计幂等处理。QoS 2 提供 MQTT 协议层面的恰好一次传递,也不能自动保证数据库写入、继电器动作等跨系统副作用只发生一次。
Retained Message 是 Broker 针对某个 Topic 保存的最近一条“保留发布”。新订阅者匹配到该主题时,可以立即拿到这条状态,因此很适合保存“设备当前在线状态”“当前模式”等最新快照。它不是历史消息队列,也不要与持久会话混淆。
用命令验证发布订阅
准备一个可访问的 MQTT Broker,并在电脑安装 Mosquitto 客户端。下面先发布一条 QoS 1 的 retained 状态,再启动一个新订阅者;请先把 <IP> 和 <PORT> 替换成实际 Broker 地址和端口。
BROKER_IP="<IP>"
BROKER_PORT="<PORT>"
mosquitto_pub -h "$BROKER_IP" -p "$BROKER_PORT" \
-t "lab/esp32/status" \
-m '{"online":true}' \
-q 1 -r
mosquitto_sub -h "$BROKER_IP" -p "$BROKER_PORT" \
-t "lab/esp32/status" \
-q 1 -C 1 -v预期输出:
lab/esp32/status {"online":true}订阅命令是在发布之后才启动,却仍能立即收到消息,这正是 retained 状态的效果。若发布时去掉 -r,而订阅者又没有在发布发生时在线,就不能依靠这条机制补到此前的普通消息。
设计 ESP32 主题时的边界
设备主题最好提前形成约定:遥测、状态和命令使用不同 Topic,设备 ID 位于固定层级,后台用 + 或 # 做批量订阅。这样既便于权限控制,也便于后续把多个 ESP32 接入同一 Broker。
对控制命令,不要因为“更可靠”就机械选择 QoS 2;很多物联网系统使用 QoS 1,再通过命令 ID、确认消息和幂等执行获得更完整的业务可靠性。Retained 也更适合“当前状态”,不适合“一次性动作命令”,否则设备重连订阅后可能再次看到旧命令。
理解 MQTT 时只需抓住一条主线:发布者把带 Topic 的消息交给 Broker,Broker 按订阅规则转发;QoS 决定传递保证,Retain 决定 Broker 是否保存最新状态。后续无论换成 ESP32 库还是云端 Broker,这套模型都不变。