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

用遗嘱消息识别异常离线

用遗嘱消息识别异常离线

设备断网或进程崩溃时,往往来不及主动发布离线状态。MQTT 的 Last Will(遗嘱消息)允许客户端在连接时预先交给 Broker 一条异常通知,由 Broker 在发现非正常断开后代为发布。本课用一个状态主题验证正常退出与异常退出的差别。

学习目标

  • 解释遗嘱的登记、触发条件以及正常 DISCONNECT 为什么不会触发。
  • 使用 MQTT 客户端设置 Will Topic、QoS 和 Retain,并验证异常离线通知。
  • 避免把网络失联误判为设备故障,处理重连后的状态覆盖。

遗嘱由 Broker 在何时发布

客户端发送 CONNECT 时,可以附带遗嘱主题、载荷、QoS 和 Retain 标记。Broker 保存这些设置;后续如果检测到 TCP 连接异常关闭、网络故障或 Keep Alive 超时,便把遗嘱作为一条 PUBLISH 发给匹配的订阅者。

正常发送 DISCONNECT(MQTT 5 原因码 0x00)会取消遗嘱,不会自动出现离线消息。因此设备若希望区分两种离线原因,应在正常退出前主动发布 offline:normal,把遗嘱内容设为 offline:unexpected。MQTT 5 另有原因码 0x04,可明确请求断开时发送遗嘱,不属于普通正常退出。

遗嘱消息正常断开与异常断开的两条时序分支

用两种退出方式验证状态

准备运行中的本地 Broker(127.0.0.1:1883)、Python 3 和 Paho MQTT 2.x;安装依赖可执行 python -m pip install paho-mqtt。在独立终端先执行 mosquitto_sub -V 5 -h 127.0.0.1 -t 'devices/t01/status' -v 观察状态,然后把以下程序保存为 will_demo.py。

python
import os
import sys
import time
import paho.mqtt.client as mqtt

topic = "devices/t01/status"
client = mqtt.Client(
    mqtt.CallbackAPIVersion.VERSION2,
    client_id="t01",
    protocol=mqtt.MQTTv5,
)
# 遗嘱由 Broker 在未收到正常 DISCONNECT 时发布
client.will_set(topic, "offline:unexpected", qos=1, retain=True)
client.connect("127.0.0.1", 1883, keepalive=10)
client.loop_start()

client.publish(topic, "online", qos=1, retain=True).wait_for_publish()
print("online published", flush=True)
time.sleep(2)

if "--crash" in sys.argv:
    os._exit(1)  # 模拟进程异常结束,不发送 MQTT DISCONNECT

# 正常退出由设备自行报告状态,不依赖遗嘱
client.publish(topic, "offline:normal", qos=1, retain=True).wait_for_publish()
client.disconnect()
client.loop_stop()
print("offline:normal published", flush=True)

预期结果:执行 python will_demo.py --crash,监控终端在本轮测试中依次看到:

text
devices/t01/status online
devices/t01/status offline:unexpected

执行 python will_demo.py 则依次看到 online 与 offline:normal,不会出现 offline:unexpected。若主题已有历史保留消息,监控终端刚订阅时还可能先收到上次状态,应从本次 online 开始核对。异常通知到达时间取决于 Broker 何时察觉断线,并不保证固定为 10 秒。

保留状态与误报边界

将遗嘱的 retain 设为 True,异常离线可覆盖该主题的最后保留值;新启动的监控程序也能得到离线快照。设备重新上线时,必须再次以 retain=True 发布 online,否则旧离线状态可能继续显示。

遗嘱只能证明 Broker 观察到连接异常,不能证明设备断电,更不能检测连接仍正常时的传感器故障。频繁的短时断网可能造成离线、上线抖动;MQTT 5 可以设置 Will Delay Interval,例如 5 秒,并使 Session Expiry Interval 足够长,让设备在同一会话内及时重连时取消待发布遗嘱。本示例没有启用该延迟,便于直接看到触发效果。

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

目录与阅读设置

阅读设置

17

记录一个想法

用遗嘱消息识别异常离线

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

登录哪都通