单片机与物联网 / 系统课时
用遗嘱消息识别异常离线
用遗嘱消息识别异常离线
设备断网或进程崩溃时,往往来不及主动发布离线状态。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。
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,监控终端在本轮测试中依次看到:
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 足够长,让设备在同一会话内及时重连时取消待发布遗嘱。本示例没有启用该延迟,便于直接看到触发效果。