MQTT主题测试器
在线MQTT主题测试器,支持+和#通配符规则校验与订阅匹配验证,适用于网络协议学习、主题设计评审和消息路由调试
使用 + 表示单层通配符,使用 # 表示多层通配符(仅可出现在末尾)
每行一个主题,仅用于匹配验证,主题本身不能包含 + 或 #
常用模式
测试结果
请输入订阅模式和测试主题后开始测试
匹配
不匹配
通配符参考
+单层通配符
+ 仅匹配一个层级,不能跨层匹配。
#多层通配符
# 可匹配任意剩余层级,且必须位于订阅模式末尾。
MQTT主题模式指南
什么是 MQTT 主题过滤器?
该工具用于离线测试 MQTT 订阅过滤器,帮助你验证 + 与 # 的匹配行为,优化主题命名与消息路由。
匹配规则
- + 仅匹配一个层级,例如 sensor/+/temp 可匹配 sensor/room1/temp。
- # 匹配当前位置之后的全部层级,且只能出现在过滤器最后。
- 发布主题必须是精确主题名,不能包含 + 或 # 通配符。
- 主题区分大小写,Home/temp 与 home/temp 会被视为不同主题。
设计建议
- 按业务域、设备、指标拆分层级,例如 factory/line01/device01/temp。
- 统一命名规范,建议小写与短横线,避免多团队协作时出现歧义。
- 为批量订阅场景预留中间层级,减少后续改造成本。
常见问题
+ 和 # 的核心区别是什么?
+ 只能匹配单层,# 可以匹配多层且必须放末尾。
为什么主题测试不允许输入通配符?
因为测试主题代表发布主题名,MQTT 规范中发布主题不能带通配符。
如何快速定位不匹配原因?
查看结果中的红色差异标签与层级原因提示,可快速判断是层级数量问题还是节点文本不一致。