Skip to main content

MQTT（开发者）

发布/订阅消息协议。围绕订阅主题（收）与发布主题（发）组织，参数在请求的 MQTT 设置里配置。

界面怎么配​

在 MQTT 请求的连接设置里填：

配置项说明
客户端 ID (clientId)本连接的身份标识
订阅列表一组主题 + QoS，连上后自动订阅
发布主题默认往这个主题发消息
发布 QoS / 保留(retain)发送时的服务质量与是否保留
  • 主题通配：# 匹配多层、+ 匹配单层（如 qr/manual/#）。
  • QoS：0（最多一次）/ 1（至少一次）/ 2（恰好一次）。
  • 主机填 broker 地址、端口单填（如 127.0.0.1:18884）；mqtts:// 走 TLS。

核心流程​

怎么用​

  1. 建 MQTT 请求，按上表配好 clientId、订阅主题、发布主题。
  2. 连接：会话会按你的配置自动订阅，并记住默认发布主题。
  3. 发布：直接把内容发到发布主题（也可临时改主题/QoS/retain）；空内容也合法。
  4. 收消息：界面实时显示收到的消息——既包括你发布命中订阅的"回环"，也包括 broker 推送给订阅主题的其他消息。
  5. 运行期可追加/取消订阅；用完关闭会话。

实测​

预订阅 qr/manual/# + 发布 {"evt":"auto-sub"} 到 qr/manual/hello → 返回 PUBACK(QoS1 已确认)，并收到回环消息体，收发闭环成立。

注意事项​

  • 发布后收不到自己：确认发布主题命中了某个订阅主题（如都落在 qr/manual/# 下）。
  • 追加/取消的订阅只在当前会话有效，会话关闭就没了——要长期生效就写在请求的订阅配置里。
  • 长连接占配额、空闲自动回收，调试完关闭。

相关：订阅通配符与 QoS 说明见上文；连接配置由环境的 mqtt 前置 URL 承担（见 concepts）。