单片机与物联网 / 系统课时
跟踪订阅建立和取消过程
跟踪订阅建立和取消过程
客户端发出 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。
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 设置下,预期输出为:
连接成功
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 代替。若取消后还收到消息,应检查是否存在重叠订阅,或者消息是否在取消生效前已经发出。