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

跟踪订阅建立和取消过程

跟踪订阅建立和取消过程

客户端发出 SUBSCRIBE 后,发送成功并不等于 Broker 已接受订阅;取消订阅也不能只看客户端调用是否返回。通过匹配报文标识符并检查 SUBACK、UNSUBACK 的逐项结果,可以确定过滤器何时被接受、拒绝或移除。

学习目标

  • 按报文标识符关联订阅、取消订阅与各自的确认报文。
  • 解释 SUBACK 授权 QoS 和 UNSUBACK 取消结果。
  • 使用 MQTT 5 客户端验证完整交互并定位常见误判。

从四种报文识别一次操作

MQTT 的订阅关系由 Broker 为客户端会话维护。客户端发送的过滤器可以是 room/+/temp,它匹配 room/a/temp,但不能把 room/#/temp 当作合法过滤器,因为 # 只能出现在末尾并独占一个主题层级。

报文 方向 抓包时核对的内容
SUBSCRIBE(首字节 0x82) 客户端到 Broker Packet Identifier、Topic Filter、请求 QoS 等选项
SUBACK(0x90) Broker 到客户端 相同 Packet Identifier、每个过滤器的原因码
UNSUBSCRIBE(0xA2) 客户端到 Broker 新一次请求的 Packet Identifier、要移除的原过滤器
UNSUBACK(0xB0) Broker 到客户端 与取消请求相同的 Packet Identifier、逐项取消结果

这里的首字节指控制报文固定报头的第一个字节,不是整个报文。Packet Identifier 是请求和应答的配对依据;发送多个过滤器时,SUBACK、UNSUBACK 中的原因码都按原请求的过滤器顺序一一对应。

顺着时序确认订阅与移除

假设客户端用 Packet Identifier 17 请求订阅 room/+/temp,请求 QoS 1。Broker 返回同一标识符的 SUBACK,原因码为 0x01,表示实际授予 QoS 1。之后客户端用标识符 18 取消同一个过滤器,收到 0x00 的 UNSUBACK,表示删除成功。

订阅建立和取消的消息时序

用 Python 检查请求和应答

先启动支持 MQTT 5 的本地 Broker,确保监听 127.0.0.1:1883,并安装 Python 依赖:python -m pip install paho-mqtt==2.1.0。将以下代码保存为 subscription_trace.py 后运行 python subscription_trace.py。示例使用 Paho 2.x 的回调 API V2。

python
import paho.mqtt.client as mqtt

TOPIC = "room/+/temp"
pending = {}

def on_connect(client, userdata, flags, reason_code, properties):
    if reason_code.is_failure:
        print("连接被拒绝:", reason_code)
        client.disconnect()
        return
    print("连接成功")
    result, mid = client.subscribe(TOPIC, qos=1)
    if result != mqtt.MQTT_ERR_SUCCESS:
        print("发送订阅请求失败")
        client.disconnect()
        return
    pending["subscribe"] = mid  # 保存本次请求的报文标识符

def on_subscribe(client, userdata, mid, reason_codes, properties):
    print("SUBACK 标识符匹配:", mid == pending["subscribe"])
    print("SUBACK 原因码:", [code.value for code in reason_codes])
    if not reason_codes or any(code.is_failure for code in reason_codes):
        client.disconnect()
        return
    # 只有确认订阅已被接受,才请求移除相同的过滤器。
    result, unsub_mid = client.unsubscribe(TOPIC)
    if result != mqtt.MQTT_ERR_SUCCESS:
        print("发送取消请求失败")
        client.disconnect()
        return
    pending["unsubscribe"] = unsub_mid

def on_unsubscribe(client, userdata, mid, reason_codes, properties):
    print("UNSUBACK 标识符匹配:", mid == pending["unsubscribe"])
    print("UNSUBACK 原因码:", [code.value for code in reason_codes])
    client.disconnect()

client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, protocol=mqtt.MQTTv5)
client.on_connect = on_connect
client.on_subscribe = on_subscribe
client.on_unsubscribe = on_unsubscribe
client.connect("127.0.0.1", 1883, 60)
client.loop_forever()

在允许匿名连接、允许该主题订阅并支持 QoS 1 的常见本地 Broker 设置下,预期输出为:

text
连接成功
SUBACK 标识符匹配: True
SUBACK 原因码: [1]
UNSUBACK 标识符匹配: True
UNSUBACK 原因码: [0]

Packet Identifier 的具体数值由客户端库分配,可能不同;代码通过比较请求和应答的标识符避免依赖固定数字。若 Broker 未运行,连接会失败,不会得到上述输出。

区分失败、空操作和残留消息

SUBACK 的 0x00、0x01、0x02 分别表示授予 QoS 0、1、2,可能低于所请求的 QoS;0x87 表示未授权,0x8F 表示过滤器不可接受。一次订阅多个过滤器时,即使部分成功,也必须逐项检查失败项,不能仅凭收到 SUBACK 认定全部成功。

UNSUBACK 的 0x00 表示已删除;0x11 表示该过滤器本来就没有订阅,属于非失败结果。取消时须使用与原订阅完全相同的 Topic Filter 字符串,不能用某条已匹配的实际 Topic Name 代替。若取消后还收到消息,应检查是否存在重叠订阅,或者消息是否在取消生效前已经发出。

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

目录与阅读设置

阅读设置

17

记录一个想法

跟踪订阅建立和取消过程

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

登录哪都通