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

用通配符订阅一组设备主题

用通配符订阅一组设备主题

监控服务需要同时接收数百台设备的数据时,为每个完整主题建立订阅既繁琐又容易遗漏。本课使用 + 和 # 编写 MQTT 主题过滤器,在本地 Broker 上发布测试消息,验证哪些主题能够匹配,并识别容易造成消息遗漏或误收的边界。

学习目标

  • 理解 MQTT 主题层级与订阅过滤器的关系。
  • 区分单层通配符 + 和多层通配符 # 的匹配范围。
  • 使用 Mosquitto 客户端验证匹配结果,并排查常见订阅错误。

约定设备主题的层级

假设一个智能建筑系统需要接收不同房间的温度、湿度和电池状态。设备发布消息时使用以下主题:

  • devices/room-a/temperature:A 房间的温度。
  • devices/room-a/humidity:A 房间的湿度。
  • devices/room-b/temperature:B 房间的温度。
  • devices/room-a/sensor/battery:A 房间某类传感器的电池状态。

MQTT 使用 / 分隔主题层级。Broker 根据订阅过滤器与实际发布主题的匹配关系决定消息投递范围。这里的层级是主题命名规则,并不要求 Broker 预先创建目录或设备节点。

如果监控程序只订阅 devices/room-a/temperature,就只能接收这个完整主题上的消息。新增房间后,还要添加对应订阅。使用通配符可以直接订阅一组具有共同命名规律的主题。

需要注意,发布端必须使用具体主题名称,不能在 PUBLISH 的主题名称中使用 + 或 #。通配符只属于订阅过滤器。

两种通配符的匹配范围

单层通配符 + 匹配恰好一个主题层级,必须独占整个层级。例如,devices/+/temperature 匹配 devices/room-a/temperature 和 devices/room-b/temperature,但不匹配 devices/room-a/sensor/temperature,因为后者多出一个层级。

多层通配符 # 匹配零个或多个后续层级,必须独占最后一个层级。例如,devices/# 既匹配 devices,也匹配 devices/room-a/temperature 和更深层级的主题。

下面用实际主题检验边界:

订阅过滤器 发布主题 是否匹配
devices/+/temperature devices/room-a/temperature 是
devices/+/temperature devices/room-a/sensor/temperature 否
devices/+/temperature devices//temperature 是,+ 可匹配空层级
devices/# devices 是,# 可匹配零层
devices/# devices/room-a/sensor/battery 是
devices/+/battery devices/room-a/sensor/battery 否

devices/room+/temperature 和 devices/#/temperature 都不是合法过滤器:前者的 + 没有独占层级,后者的 # 不在末尾。主题名称还区分大小写,Devices 与 devices 不相同。

验证单层过滤器

准备已经安装的 Mosquitto Broker、mosquitto_sub 和 mosquitto_pub。本例使用本机测试 Broker,地址为 127.0.0.1,端口为 1883。如未启动 Broker,可执行 mosquitto -p 1883,预期进程保持前台运行并监听该端口;如果服务已监听,则不必重复启动。实际部署地址和端口应按环境调整。

先在终端 A 启动订阅者:

bash
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/+/temperature' -v -R -C 2

预期结果:订阅程序开始等待消息。-v 同时显示主题和载荷,-R 不打印保留消息,-C 2 表示接收两条符合条件的消息后退出。这里明确使用 MQTT 3.1.1 协议进行测试。

保持终端 A 运行,在终端 B 依次发布三条消息:

bash
# 两条温度消息,中间插入一条湿度消息验证过滤效果
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/room-a/temperature' -m '23.5'
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/room-a/humidity' -m '50'
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/room-b/temperature' -m '25.0'

预期输出(终端 A):

text
devices/room-a/temperature 23.5
devices/room-b/temperature 25.0

发布端正常执行通常没有标准输出。湿度主题不匹配过滤器,因此终端 A 不会显示数值 50。收到两条温度消息后,订阅程序自动退出。

这说明 + 可以替代房间编号层级,但不会忽略末尾的 temperature 条件,也不会跨越两个主题层级。

验证多层过滤器

现在需要把同一设备前缀下的温度、湿度和更深层级的状态消息全部交给诊断程序。使用 devices/# 可以覆盖这组主题。

重新在终端 A 运行:

bash
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/#' -v -R -C 3

预期结果:终端 A 等待最多三个符合过滤器的消息;收到第三条后退出。

在终端 B 依次执行:

bash
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices' -m 'root'
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/room-a/temperature' -m '23.5'
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/room-a/sensor/battery' -m '90'

预期输出(终端 A):

text
devices root
devices/room-a/temperature 23.5
devices/room-a/sensor/battery 90

第一条消息说明 # 可以匹配零个后续层级,第二条和第三条分别验证单层与多层后代主题。这里假设使用独立测试 Broker,且没有其他客户端同时向 devices/ 发布消息。

实际项目中,设备数据采集服务可以订阅 devices/+/temperature,设备诊断服务则可以订阅 devices/#。后者接收范围更广,会增加传输与处理的消息量,应结合用途和访问权限控制订阅范围。

排查没有收到或收到太多消息

当订阅结果不符合预期时,先检查主题,而不是立即怀疑网络或 Broker 故障。

  • 检查层级数量:devices/+/temperature 不会匹配多出 sensor 层级的主题。如果确实需要任意深度,应重新设计过滤器或使用 devices/#。
  • 检查过滤器是否合法:+ 必须独占一个层级,# 必须独占最后一个层级。Shell 中应给包含通配符的过滤器加引号。
  • 检查大小写与空层级:devices/room-a 和 devices/Room-A 是不同主题,连续两个 / 还会产生空层级。
  • 检查系统主题:以通配符开头的过滤器,如 # 或 +/status,不会匹配以 $ 开头的主题。若 Broker 提供 $SYS 系统主题,需要单独订阅 $SYS/#,且仍受 Broker 权限与实现限制。
  • 检查 Broker 连接与权限:如果精确主题和通配符主题都收不到消息,应核对地址、端口、认证、ACL 及订阅是否已经建立。

可以再做一次小实验:将订阅条件改为 devices/room-a/#,分别向 A 房间和 B 房间发布温度数据。预期只有 A 房间的消息被接收。若结果不符,逐层比较过滤器和发布主题即可定位差异。

生产环境建议按设备、地点与数据类型约定统一的主题命名方式,并以最小必要范围订阅。需要核查通配符规范时,可参考 MQTT 3.1.1 主题匹配规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

用通配符订阅一组设备主题

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

登录哪都通