连接与订阅

添加、查看和取消订阅

同一 Broker 连接下,按订阅主题独立选择 JSON、Text 或 Hex,配置 QoS 并确认订阅实际生效。

浏览全部手册
本页目录

添加订阅

  1. 选中目标连接并确认已连接。
  2. 点击「当前连接的订阅」旁的加号。
  3. 填写 Topic 过滤器,选择 QoS 和消息格式。
  4. 点击「确认订阅」,等待状态变化,再用一条实际消息验证。
字段 示例 说明
Topic 过滤器 device/sensor/# 可填写精确主题或合法通配符
QoS 0 / 1 / 2 订阅请求的质量等级,最终受 broker 和发布 QoS 影响
消息格式 JSON / Text / Hex 决定收到消息后的展示方式,不修改设备发送内容

当前添加订阅弹窗每次初始 QoS 为 0,消息格式为 JSON。即使修改了设置里的默认 QoS,也应在该弹窗再次明确选择。

在添加订阅时,分别选择 Topic 过滤器、QoS 和消息格式。图中为 device/+/raw 选择 Hex。
为主题设置独立格式 · 在添加订阅时,分别选择 Topic 过滤器、QoS 和消息格式。图中为 device/+/raw 选择 Hex。
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 注册;重叠订阅可能收到重复消息或重复保留消息,不承诺自动去重。

查看当前订阅对应的消息

选中 device/+/status 后只显示该订阅相关消息,JSON 载荷按结构展示。(原始实机画面的局部截取)
JSON 主题消息 · 选中 device/+/status 后只显示该订阅相关消息,JSON 载荷按结构展示。(原始实机画面的局部截取)
0.1.0 开发版 · 2026-11-02 实机采集 · 点击查看原图 ↗

当前订阅确认与离线删除

新增、复制与恢复订阅以真实 broker ACK 为准,再保存本地记录。重叠过滤器分别注册自己的 QoS,broker 可能产生重复或保留消息,工具不承诺去重。

在线删除宽过滤器前,先确认受影响的剩余过滤器,再取消原过滤器;失败保留原记录并提示。离线删除先保存待清理意图,下次连接先完成清理再恢复已有过滤器。持久会话中也要核对 broker 状态,不能以本地删除成功替代远端确认。

仍有疑问?按反馈清单整理复现信息 →