mqtt 请求/响应

MQTT 5.0 请求/响应完整指南

一、为什么需要请求/响应

在标准的发布/订阅模型中,发布者把消息发给 Broker 后就结束了。QoS 1 或 2 只能保证消息到达了 Broker,发布者无法知道订阅端(比如设备)是否真正收到、处理并执行了这条指令。

对于需要确认结果的场景——比如远程开锁、下发配置后确认生效、查询设备状态——这种“只知发送,不知结果”的模式是不够的。因此需要一套机制来“闭环”,让接收方能够返回执行结果。

二、MQTT 3.1.1 的手工做法

在 MQTT 3.1.1 中,没有原生的请求/响应机制,只能靠约定:

  1. 请求方发送请求到某个主题(比如 device/123/command)。
  2. 请求方同时订阅一个自己定义的响应主题(比如 client/a/reply)。
  3. 请求方在请求的 Payload 里带上一个唯一 ID。
  4. 响应方处理完请求后,把结果发布到 client/a/reply,并在 Payload 里原样带回那个唯一 ID。
  5. 请求方收到响应后,通过唯一 ID 匹配是哪条请求的回复。

这种方式能实现请求/响应,但所有规则都是“约定”出来的,不是协议标准。

三、MQTT 5.0 的标准化方案

MQTT 5.0 把请求/响应模式标准化了,通过两个属性实现:

属性 作用 谁设置
Response Topic 告诉响应方把结果发到这个主题 请求方在请求消息里设置
Correlation Data 用于匹配请求和响应 请求方设置唯一值,响应方原样返回

四、完整交互流程

假设 A 是请求方,B 是响应方。

  1. A 订阅响应主题:A 先订阅一个自己将要使用的响应主题,比如 client/a/reply,确保能收到返回的消息。
  2. A 发送请求:A 通过 PUBLISH 报文发送请求到 device/123/command,并在消息属性里设置 Response Topic 和 Correlation Data。
  3. B 处理并返回:B 订阅了 device/123/command,收到请求后执行业务逻辑。然后 B 把结果通过 PUBLISH 发送到请求中指定的 Response Topic,并原样附带 Correlation Data。
  4. A 关联响应:A 从自己订阅的响应主题收到消息后,通过比对 Correlation Data 来确认这是对哪一次请求的响应。

五、响应消息的格式

MQTT 5.0 没有强制规定响应消息的 Payload 格式,这部分由业务决定。但响应消息的主题和属性有明确规范。

响应方发送的 PUBLISH 报文必须满足:

  • Topic:必须是请求消息中 Response Topic 属性指定的值。
  • Properties:必须包含 Correlation Data 属性,且内容与请求消息中的完全一致。

Payload 可以放 JSON,比如 {"code": 0, "msg": "success", "data": {"status": "unlocked"}}。

六、示例场景:服务端请求设备获取状态

请求消息:

项目 值
Topic service/device/123/getProperties
Properties Response Topic: client/a/reply,Correlation Data: 8f1c2d9a
Payload {"operation":"getStatus"}

响应消息:

项目 值
Topic client/a/reply(由请求的 Response Topic 决定)
Properties Correlation Data: 8f1c2d9a(原样返回)
Payload {"status":"online","temperature":36.5}

七、HiveMQ SDK 的设置方式

以 HiveMQ MQTT Client 为例:

发送请求时:

client.toAsync().publishWith()
    .topic("device/123/command")
    .payload(requestPayload.getBytes())
    .responseTopic("device/123/reply")
    .correlationData(UUID.randomUUID().toString().getBytes())
    .qos(MqttQos.AT_LEAST_ONCE)
    .send();

接收响应时:

client.toAsync().subscribeWith()
    .topicFilter("device/123/reply")
    .callback(publish -> {
        ByteBuffer correlationData = publish.getCorrelationData().orElse(null);
        if (correlationData != null) {
            String requestId = new String(correlationData.array());
            log.info("收到请求 {} 的响应: {}", requestId, new String(publish.getPayloadAsBytes()));
        }
    })
    .send();

八、注意事项

  • 请求方必须在发送请求前订阅好响应主题,否则可能错过响应消息。
  • 双方都必须支持 MQTT 5.0,否则这两个属性无法生效。
  • 响应主题是请求方动态指定的,不是预先约定的固定值。
  • Correlation Data 由请求方生成,响应方必须原样返回,不能修改。

九、一句话总结

MQTT 5.0 通过 Response Topic 和 Correlation Data 两个属性,把请求/响应模式标准化了。请求方指定响应主题和关联数据,响应方处理完后把结果发到指定主题并原样带回关联数据,请求方通过关联数据匹配响应。Payload 格式由业务决定,通常用 JSON。

最后编辑于 :
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

友情链接更多精彩内容