单片机与物联网 / 系统课时
用通配符订阅一组设备主题
用通配符订阅一组设备主题
监控服务需要同时接收数百台设备的数据时,为每个完整主题建立订阅既繁琐又容易遗漏。本课使用 + 和 # 编写 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 启动订阅者:
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 依次发布三条消息:
# 两条温度消息,中间插入一条湿度消息验证过滤效果
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):
devices/room-a/temperature 23.5
devices/room-b/temperature 25.0发布端正常执行通常没有标准输出。湿度主题不匹配过滤器,因此终端 A 不会显示数值 50。收到两条温度消息后,订阅程序自动退出。
这说明 + 可以替代房间编号层级,但不会忽略末尾的 temperature 条件,也不会跨越两个主题层级。
验证多层过滤器
现在需要把同一设备前缀下的温度、湿度和更深层级的状态消息全部交给诊断程序。使用 devices/# 可以覆盖这组主题。
重新在终端 A 运行:
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -t 'devices/#' -v -R -C 3预期结果:终端 A 等待最多三个符合过滤器的消息;收到第三条后退出。
在终端 B 依次执行:
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):
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 主题匹配规则。