添加、查看和取消订阅
同一 Broker 连接下,按订阅主题独立选择 JSON、Text 或 Hex,配置 QoS 并确认订阅实际生效。
浏览全部手册
本页目录
添加订阅
- 选中目标连接并确认已连接。
- 点击「当前连接的订阅」旁的加号。
- 填写 Topic 过滤器,选择 QoS 和消息格式。
- 点击「确认订阅」,等待状态变化,再用一条实际消息验证。
| 字段 | 示例 | 说明 |
|---|---|---|
| Topic 过滤器 | device/sensor/# | 可填写精确主题或合法通配符 |
| QoS | 0 / 1 / 2 | 订阅请求的质量等级,最终受 broker 和发布 QoS 影响 |
| 消息格式 | JSON / Text / Hex | 决定收到消息后的展示方式,不修改设备发送内容 |
当前添加订阅弹窗每次初始 QoS 为 0,消息格式为 JSON。即使修改了设置里的默认 QoS,也应在该弹窗再次明确选择。
0.1.0 开发版 · 2026-11-02 实机采集 · 点击查看原图 ↗
查看状态与命中
订阅项显示 Topic、状态、QoS、显示格式和命中计数。点击订阅可以筛选实时消息区的 RX 接收消息;TX 发送记录不受该订阅筛选影响。筛选条上的取消按钮可恢复显示。
订阅项的颜色用于关联匹配消息,不代表连接错误级别。一个消息可能同时命中多个订阅,见订阅匹配。
格式如何选择
消息格式配置在每条订阅上,同一个 Server / Broker 连接可以同时使用多种显示格式。 不必给整个连接统一设置一种格式,也无需为不同格式分别创建连接。例如,选中同一个设备连接,依次添加三条订阅:
| 订阅主题 | 消息内容 | 显示格式 |
|---|---|---|
devices/pump-01/telemetry |
温度、压力等结构化数据 | JSON |
devices/pump-01/log |
设备运行日志 | Text |
devices/pump-01/raw |
原始二进制报文 | Hex |
每次添加时,在「消息格式」中选择该订阅需要的格式。配置影响本地接收消息的展示方式,不修改设备发送的内容;这些主题是配置示例,实际接收还需要设备向对应主题发布消息,或用有权限的测试客户端发送。
结构化文本选 JSON,普通文本选 Text,原始字节排查选 Hex。JSON 展示失败时可能是载荷本身不是合法 JSON,工具不会把任意二进制自动转换成业务对象。
取消订阅
通过订阅项「更多订阅操作 → 取消订阅…」,核对 Topic 后确认。取消订阅与清空消息是不同操作:不需要继续监听时取消订阅,只想清理显示时使用「清空视图」。
离线时取消订阅会先保存待清理记录,再移除本地订阅。下一次成功连接时,工具先尝试向 Broker 清理已取消的过滤器,再恢复保留的订阅;待清理记录跨应用重启保留。离线取消不代表 Broker 已立即收到取消请求。
如果 Broker 确认失败或本地保存失败,查看日志并在下次连接后复核。取消宽泛订阅时,工具会先确认被它覆盖的保留订阅,避免误停仍需接收的主题;失败时不要把列表变化当成成功。
重复与覆盖提示
添加 device/# 后再添加 device/sensor/#,可能出现覆盖提示。这是在提醒匹配范围重叠,不一定是订阅失败。检查实际需求后保留必要的过滤器。每条已保存过滤器会按自身 QoS 注册;重叠订阅可能收到重复消息或重复保留消息,不承诺自动去重。
查看当前订阅对应的消息
0.1.0 开发版 · 2026-11-02 实机采集 · 点击查看原图 ↗
当前订阅确认与离线删除
新增、复制与恢复订阅以真实 broker ACK 为准,再保存本地记录。重叠过滤器分别注册自己的 QoS,broker 可能产生重复或保留消息,工具不承诺去重。
在线删除宽过滤器前,先确认受影响的剩余过滤器,再取消原过滤器;失败保留原记录并提示。离线删除先保存待清理意图,下次连接先完成清理再恢复已有过滤器。持久会话中也要核对 broker 状态,不能以本地删除成功替代远端确认。
仍有疑问?按反馈清单整理复现信息 →