单片机与物联网 / 系统课时

理解 MQTT 模型

理解 MQTT 模型

MQTT 的关键不是“ESP32 怎样连服务器”,而是把设备从点对点通信改造成由 Broker 中转的发布订阅系统。本节从 Broker、主题、QoS 与保留消息四个核心概念出发,并用一组命令验证消息如何被路由给后来订阅的客户端。

学习目标

  • 说清 Publisher、Broker、Subscriber 之间的职责边界
  • 用主题和通配符组织设备消息,而不是依赖客户端地址
  • 根据消息重要性选择 QoS,并理解 Retained Message 的用途

从客户端直连改成 Broker 中转

MQTT 客户端先与 Broker 建立连接。发布者把消息发送到某个 Topic,Broker 再根据订阅关系把消息转发给匹配的订阅者。发布者因此不需要知道消费者的 IP、数量或是否是网页、云服务还是另一块 ESP32。

MQTT 发布订阅与保留消息数据流

这种解耦是 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 地址和端口。

bash
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

预期输出:

text
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,这套模型都不变。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 MQTT 模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通