单片机与物联网 / 系统课时
用响应主题完成请求应答
用响应主题完成请求应答
设备命令发出后,调用方需要确认设备是否处理,而不只是消息到达 Broker。本篇借助 MQTT 5 的 Response Topic 与 Correlation Data 构建可关联的请求应答流程,并用 Python 验证回包匹配。
学习目标
- 说明响应主题与关联数据各自承担的职责。
- 实现先订阅响应、再发布请求、最后匹配回包的完整流程。
- 识别超时、重复响应以及响应主题权限的边界。
两个属性分别解决什么问题
假设监控平台向设备发出 get_state,请求消息发布到 lab/rpc/request。MQTT 原有的 PUBLISH/PUBACK 只能表达协议层的消息交付,不能证明设备已执行命令;业务应答必须由设备另行发布。
MQTT 5 在请求 PUBLISH 的属性区提供两个字段:
Response Topic:请求方希望接收回答的主题,例如lab/rpc/reply/rpc-req-demo。它是普通主题名,不得包含+、#通配符。Correlation Data:由请求方生成的二进制关联值。应答方将该值原样放入响应 PUBLISH,供请求方关联本次请求。
Broker 不会根据这两个字段自动订阅响应主题、执行命令或生成应答,只负责按普通发布订阅规则转发消息。关联值也不是 MQTT 的 Packet Identifier,不能依赖 QoS 报文 ID 跨两条 PUBLISH 关联业务请求。
从订阅到回包的消息顺序

- 请求方先订阅自己的响应主题,等待 Broker 返回 SUBACK。
- 请求方发布携带
ResponseTopic和CorrelationData的请求;设备订阅请求主题。 - 设备从请求消息属性中读取响应主题与关联值,处理业务后发布新的响应消息。
- 请求方只把关联值相符的响应交给相应的等待任务;超时请求从待处理表移除。
先等 SUBACK 很重要:若请求与响应很快完成,而响应主题尚未订阅成功,响应可能无人接收。一个请求方可以用同一响应主题处理多个并发请求,但每个在途请求都要有不同的关联值。
Python 跑通一次请求应答
先运行支持 MQTT 5 的本地 Broker,示例使用 127.0.0.1:1883;安装 Python 库 paho-mqtt(执行 python -m pip install paho-mqtt)。保存下面的完整程序为 mqtt_rpc_demo.py 并运行 python mqtt_rpc_demo.py。示例使用两个独立 MQTT 客户端模拟请求方和设备;实际部署的主机与端口可能不同。
import threading
import uuid
import paho.mqtt.client as mqtt
from paho.mqtt.packettypes import PacketTypes
from paho.mqtt.properties import Properties
REQUEST_TOPIC = "lab/rpc/request"
RESPONSE_TOPIC = "lab/rpc/reply/rpc-req-demo"
request_id = uuid.uuid4().bytes
ready = {"requester": threading.Event(), "responder": threading.Event()}
finished = threading.Event()
def on_connect(client, role, flags, reason_code, properties):
if reason_code.is_failure:
print(f"{role} 连接失败: {reason_code}")
return
topic = RESPONSE_TOPIC if role == "requester" else REQUEST_TOPIC
client.subscribe(topic, qos=1)
def on_subscribe(client, role, mid, reason_codes, properties):
if all(not code.is_failure for code in reason_codes):
ready[role].set()
def on_message(client, role, msg):
if role == "responder":
reply_topic = getattr(msg.properties, "ResponseTopic", None)
token = getattr(msg.properties, "CorrelationData", None)
# 不能盲目信任请求方提供的任意响应主题
if not reply_topic or token is None or not reply_topic.startswith("lab/rpc/reply/"):
return
print("设备收到请求:", msg.payload.decode("utf-8"))
response = Properties(PacketTypes.PUBLISH)
response.CorrelationData = token # 必须原样带回关联值
client.publish(reply_topic, "online", qos=1, properties=response)
elif getattr(msg.properties, "CorrelationData", None) == request_id:
print("请求方匹配响应:", msg.payload.decode("utf-8"))
finished.set()
clients = {}
for role in ("responder", "requester"):
client = mqtt.Client(
mqtt.CallbackAPIVersion.VERSION2,
client_id=f"rpc-{role}-demo",
userdata=role,
protocol=mqtt.MQTTv5,
)
client.on_connect = on_connect
client.on_subscribe = on_subscribe
client.on_message = on_message
clients[role] = client
try:
for client in clients.values():
client.connect("127.0.0.1", 1883, 60)
client.loop_start()
# 收到双方 SUBACK 后才发请求
if not all(event.wait(5) for event in ready.values()):
raise TimeoutError("请求或响应主题订阅未确认")
request = Properties(PacketTypes.PUBLISH)
request.ResponseTopic = RESPONSE_TOPIC
request.CorrelationData = request_id
clients["requester"].publish(
REQUEST_TOPIC, "get_state", qos=1, properties=request
).wait_for_publish()
if not finished.wait(5):
raise TimeoutError("等待匹配响应超时")
finally:
for client in clients.values():
client.disconnect()
client.loop_stop()预期输出(本地 Broker 正常且无其他客户端干扰时):
设备收到请求: get_state
请求方匹配响应: onlineuuid.uuid4().bytes 每轮生成不同关联值,实际值可记为 <ID>,因此不应在测试中硬编码。wait_for_publish() 只等待本次发布完成协议层交付;真正的业务完成以匹配到的响应消息为依据。
超时、重复与权限边界
正式服务应维护以关联值为键的待处理表,记录请求主题、期望响应来源、截止时间和结果状态。示例等待 5 秒只是实验超时,不能据此认定设备一定没有执行命令:设备可能已执行但应答丢失,也可能稍后才回包。
QoS 1 可能产生重复交付,因此重试带副作用的命令时还需业务幂等键或执行记录,不能靠 Correlation Data 自动去重。实际接入还应限制请求方可订阅的响应主题、设备可发布的响应主题,并校验调用者权限。尤其不要允许设备无条件向任意来路的 Response Topic 发布敏感结果。
MQTT 5 只是让请求应答信息有了标准承载位置;超时策略、幂等处理和权限验证仍由应用实现。协议定义可参考 MQTT 5.0 标准。