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

模拟断网并验证会话恢复

模拟断网并验证会话恢复

设备断网后,监控端应及时发现异常离线,业务订阅端则需要在恢复连接后取回尚未消费的消息。这里使用本地 Mosquitto 分别模拟设备进程崩溃、订阅端离线和 Broker 暂时不可达,核对遗嘱、持久会话与退避重连的实际行为。

学习目标

  • 触发异常断开并验证 Broker 发布遗嘱消息。
  • 保留 MQTT 5 会话,确认离线期间的 QoS 1 消息在重连后补发。
  • 识别退避重连、Session Present 与会话过期的不同含义。

准备本地实验与观察点

准备 Mosquitto 2.x、mosquitto_pub、mosquitto_sub 和 Bash;退避测试另需 Python 3 与 paho-mqtt 2.x。以下均连接本机 127.0.0.1:1883。确认端口未被占用,在独立终端启动测试 Broker:

bash
mosquitto -p 1883 -v

预期结果:Broker 保持运行,日志出现监听 1883 端口的信息;日志时间和版本因环境而异。Mosquitto 2.x 无自定义监听配置时可用于本机实验;不要把未鉴权的测试监听暴露到公网。

MQTT 异常断开、遗嘱通知与离线队列补发时序

用异常退出触发遗嘱

先在终端 A 订阅设备状态;命令会持续等待消息:

bash
mosquitto_sub -V 5 -h 127.0.0.1 -t lab/motor-07/status -v

预期结果:开始时没有输出。再在终端 B 运行下列 Bash 命令,让模拟设备注册遗嘱并在连接建立后被强制终止:

bash
# Kill 不发送 MQTT DISCONNECT,用来模拟进程崩溃。
mosquitto_sub -V 5 -h 127.0.0.1 -i motor-07 \
  -t lab/motor-07/commands \
  --will-topic lab/motor-07/status \
  --will-payload offline --will-qos 1 >/dev/null &
device_pid=$!
sleep 2
kill -9 "$device_pid"

预期结果:终端 A 收到:

text
lab/motor-07/status offline

Broker 检测到连接异常结束才会发布遗嘱;正常发送 MQTT DISCONNECT 不会触发。这里没有设置 Will Delay,因而不等待额外的遗嘱延迟。遗嘱表示“连接已异常中断”,设备重连后仍需主动报告在线状态。

在离线期间积压并恢复消息

持久会话要先建立订阅关系,再断开连接。以下命令在同一个 Bash 终端执行:首次测试请确保 recovery-sub 没有旧会话;先建立 QoS 1 订阅,断开后发布一条消息,再用同一 Client ID 恢复。

bash
# -c 保留会话,-x 120 指定 MQTT 5 断开后会话保留 120 秒。
mosquitto_sub -V 5 -h 127.0.0.1 -i recovery-sub \
  -c -x 120 -q 1 -t lab/motor-07/telemetry >/dev/null &
sub_pid=$!
sleep 2
kill -9 "$sub_pid"

mosquitto_pub -V 5 -h 127.0.0.1 -q 1 \
  -t lab/motor-07/telemetry -m 'temp=27.4'

mosquitto_sub -V 5 -h 127.0.0.1 -i recovery-sub \
  -c -x 120 -q 1 -t lab/motor-07/telemetry -C 1 -W 10

预期关键输出:

text
temp=27.4

-c 使重连不清除既有会话,-x 120 设置离线保留期限;两次连接必须使用相同 Client ID。测试在 120 秒内完成,且 Broker 一直运行。只有订阅已建立、QoS 满足保留条件且队列未超限的消息才能期望补发;QoS 0 不具有同样的离线交付保障。

检查退避重连与恢复标记

把下面的程序保存为 reconnect_demo.py,在已安装 paho-mqtt 2.x 的环境运行。它使用 MQTT 5、持久会话属性和 Paho 内置的指数退避,连接失败后重试间隔从约 1 秒逐步增至 8 秒:

python
from datetime import datetime
import paho.mqtt.client as mqtt
from paho.mqtt.packettypes import PacketTypes
from paho.mqtt.properties import Properties

def report(message):
    print(f"{datetime.now():%H:%M:%S} {message}", flush=True)

def on_connect(client, userdata, flags, reason_code, properties):
    report(f"connected session_present={flags.session_present}")
    # 服务器没有恢复旧会话时,才重新建立订阅。
    if reason_code == 0 and not flags.session_present:
        client.subscribe("lab/motor-07/telemetry", qos=1)

def on_connect_fail(client, userdata):
    report("connect_failed")

def on_disconnect(client, userdata, disconnect_flags, reason_code, properties):
    report(f"disconnected reason={reason_code}")

props = Properties(PacketTypes.CONNECT)
props.SessionExpiryInterval = 120
client = mqtt.Client(
    mqtt.CallbackAPIVersion.VERSION2,
    client_id="retry-sub",
    protocol=mqtt.MQTTv5,
)
client.on_connect = on_connect
client.on_connect_fail = on_connect_fail
client.on_disconnect = on_disconnect
# 网络环路自动退避重连;此处不包含随机抖动。
client.reconnect_delay_set(min_delay=1, max_delay=8)
client.connect_async(
    "127.0.0.1", 1883, keepalive=10,
    clean_start=mqtt.MQTT_CLEAN_START_FIRST_ONLY,
    properties=props,
)
client.loop_forever()

预期结果:Broker 可达时打印 connected session_present=False(首次会话);在另一个终端暂时停止 Broker,会陆续看到 disconnected、connect_failed,恢复 Broker 后重新打印 connected,示例日志如下:

text
<TIME> connected session_present=False
<TIME> disconnected reason=<REASON>
<TIME> connect_failed
<TIME> connected session_present=False

<TIME> 和 <REASON> 随环境变化。上例重启的是未启用持久化存储的测试 Broker,因此新的 Session Present 通常为 False;若只中断客户端网络、Broker 保持原会话,重连时应为 True。生产设备群还应为退避加入随机抖动,避免同时抢连。

定位恢复失败的边界

  • 收不到遗嘱:检查状态订阅是否先建立、Will Topic 是否一致、是否错误地使用了正常断开,以及 Broker 是否仍在运行。
  • 离线消息没回来:检查订阅是否在离线前确认建立、Client ID 是否一致、Clean Start 是否清理会话、120 秒是否过期,以及 Broker 队列限额。
  • 重连成功却无旧订阅:优先看 CONNACK 的 Session Present。它为 False 时应重新订阅;Broker 重启后能否恢复会话还取决于服务端持久化配置。
  • 大量设备同时重连:检查重试间隔是否退避并添加抖动;连接恢复后再分批恢复订阅和上报。

验证通过的标准是:异常断开出现一次遗嘱、会话有效期内收到先前积压的 QoS 1 消息、连接恢复后能依据 Session Present 判断是否需要重建订阅。

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

目录与阅读设置

阅读设置

17

记录一个想法

模拟断网并验证会话恢复

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

登录哪都通