MQTT 5.0 请求/响应完整指南
一、为什么需要请求/响应
在标准的发布/订阅模型中,发布者把消息发给 Broker 后就结束了。QoS 1 或 2 只能保证消息到达了 Broker,发布者无法知道订阅端(比如设备)是否真正收到、处理并执行了这条指令。
对于需要确认结果的场景——比如远程开锁、下发配置后确认生效、查询设备状态——这种“只知发送,不知结果”的模式是不够的。因此需要一套机制来“闭环”,让接收方能够返回执行结果。
二、MQTT 3.1.1 的手工做法
在 MQTT 3.1.1 中,没有原生的请求/响应机制,只能靠约定:
- 请求方发送请求到某个主题(比如
device/123/command)。 - 请求方同时订阅一个自己定义的响应主题(比如
client/a/reply)。 - 请求方在请求的 Payload 里带上一个唯一 ID。
- 响应方处理完请求后,把结果发布到
client/a/reply,并在 Payload 里原样带回那个唯一 ID。 - 请求方收到响应后,通过唯一 ID 匹配是哪条请求的回复。
这种方式能实现请求/响应,但所有规则都是“约定”出来的,不是协议标准。
三、MQTT 5.0 的标准化方案
MQTT 5.0 把请求/响应模式标准化了,通过两个属性实现:
| 属性 | 作用 | 谁设置 |
|---|---|---|
| Response Topic | 告诉响应方把结果发到这个主题 | 请求方在请求消息里设置 |
| Correlation Data | 用于匹配请求和响应 | 请求方设置唯一值,响应方原样返回 |
四、完整交互流程
假设 A 是请求方,B 是响应方。
- A 订阅响应主题:A 先订阅一个自己将要使用的响应主题,比如
client/a/reply,确保能收到返回的消息。 - A 发送请求:A 通过 PUBLISH 报文发送请求到
device/123/command,并在消息属性里设置 Response Topic 和 Correlation Data。 - B 处理并返回:B 订阅了
device/123/command,收到请求后执行业务逻辑。然后 B 把结果通过 PUBLISH 发送到请求中指定的 Response Topic,并原样附带 Correlation Data。 - 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。