单片机与物联网 / 系统课时

用响应主题完成请求应答

用响应主题完成请求应答

设备命令发出后,调用方需要确认设备是否处理,而不只是消息到达 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 关联业务请求。

从订阅到回包的消息顺序

MQTT 5 请求应答与关联数据回传时序

  1. 请求方先订阅自己的响应主题,等待 Broker 返回 SUBACK。
  2. 请求方发布携带 ResponseTopic 和 CorrelationData 的请求;设备订阅请求主题。
  3. 设备从请求消息属性中读取响应主题与关联值,处理业务后发布新的响应消息。
  4. 请求方只把关联值相符的响应交给相应的等待任务;超时请求从待处理表移除。

先等 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 客户端模拟请求方和设备;实际部署的主机与端口可能不同。

python
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 正常且无其他客户端干扰时):

text
设备收到请求: get_state
请求方匹配响应: online

uuid.uuid4().bytes 每轮生成不同关联值,实际值可记为 <ID>,因此不应在测试中硬编码。wait_for_publish() 只等待本次发布完成协议层交付;真正的业务完成以匹配到的响应消息为依据。

超时、重复与权限边界

正式服务应维护以关联值为键的待处理表,记录请求主题、期望响应来源、截止时间和结果状态。示例等待 5 秒只是实验超时,不能据此认定设备一定没有执行命令:设备可能已执行但应答丢失,也可能稍后才回包。

QoS 1 可能产生重复交付,因此重试带副作用的命令时还需业务幂等键或执行记录,不能靠 Correlation Data 自动去重。实际接入还应限制请求方可订阅的响应主题、设备可发布的响应主题,并校验调用者权限。尤其不要允许设备无条件向任意来路的 Response Topic 发布敏感结果。

MQTT 5 只是让请求应答信息有了标准承载位置;超时策略、幂等处理和权限验证仍由应用实现。协议定义可参考 MQTT 5.0 标准。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用响应主题完成请求应答

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通