智能制造与工业软件 / 系统课时

为上报选择 QoS 和会话过期策略

为上报选择 QoS 和会话过期策略

设备每秒上报温度,也会产生停机、过温等事件。若全部使用 QoS 2,确认交互与离线积压会增加;若一律使用 QoS 0,关键事件可能丢失。下面以边缘网关上报到 MQTT Broker 为例,选定交付级别、会话保留期、重连缓存和应用层去重规则。

学习目标

  • 根据数据丢失容忍度,正确选择 MQTT QoS 0、1、2。
  • 为 MQTT 5 客户端设置 Clean Start、Session Expiry Interval 并处理重连。
  • 估算断网积压,验证 QoS 1 确认和事件幂等入库。

按业务价值选择 QoS

级别 MQTT 交付语义 适合的工业数据 需要接受的代价
QoS 0 最多一次;没有 MQTT 层确认 每秒一条温度采样,后续新值可弥补缺口 断链或丢包时可能丢样本
QoS 1 至少一次;以 PUBACK 确认 停机、过温告警、重要状态变化 重试后可能收到重复事件
QoS 2 MQTT 单段链路的恰好一次交付流程 少量对协议层重复投递极敏感的消息 四步握手、更多状态与交互

QoS 0 仅发送 PUBLISH;QoS 1 使用 PUBLISH → PUBACK;QoS 2 使用 PUBLISH → PUBREC → PUBREL → PUBCOMP。图中将三种往返关系并列,便于对照确认开销。

MQTT 三档 QoS 的发布确认时序对比

同一消息经过网关到 Broker、Broker 到平台两个交付段时,分别受发布 QoS 与订阅 QoS 约束。比如网关以 QoS 1 发布,而平台只以 QoS 0 订阅,平台这一段并不具备 QoS 1 确认保障。重要事件应让两段都支持至少 QoS 1。

为重连设置会话过期

MQTT 5 将“是否从旧会话开始”和“断线后保留多久”分开配置。需要恢复会话的固定网关可选 Clean Start = false、Session Expiry Interval = 7200(秒),并保持同一 Client ID。这允许在 Broker 实际保留会话且断线未超过两小时的前提下恢复状态;首次连接没有旧会话也会创建新会话。省略该过期属性时 MQTT 5 默认值为 0,即断线后不保留会话。

连接或断线情况 结果及客户端动作
Clean Start = true 丢弃已有会话,重新开始
Clean Start = false 且 Session Present = 1 旧会话恢复;已有订阅通常无需重订
Session Present = 0 旧会话不存在;订阅客户端必须重新订阅
断线超过 Session Expiry Interval 旧会话及其中积压的消息被清除

发布端与订阅端断线时的不同消息积压位置

如果平台只关心最近 5 分钟的实时遥测,可另给 MQTT 5 消息设置 Message Expiry Interval = 300 秒,以防恢复后消费过时样本;它与 Session Expiry Interval 是两个独立参数。关键停机事件不应直接套用这个短消息寿命。

运行一次 QoS 1 上报

准备支持 MQTT 5 的本地 Broker,监听 127.0.0.1:1883,并安装 Python paho-mqtt 2.x(例如运行 python -m pip install "paho-mqtt>=2,<3")。以下程序显式设置两小时会话过期,等待 Broker 完成 QoS 1 确认后才报告发送完成;实验端口为 1883,真实部署可能不同。

python
import json
from threading import Event
from uuid import uuid4

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

connected = Event()

def on_connect(client, userdata, flags, reason_code, properties):
    # 等待 CONNACK,避免在未确认连接时直接发布。
    if not reason_code.is_failure:
        connected.set()

client = mqtt.Client(
    mqtt.CallbackAPIVersion.VERSION2,
    client_id="edge-gw-machine01",
    protocol=mqtt.MQTTv5,
)
client.on_connect = on_connect
properties = Properties(PacketTypes.CONNECT)
properties.SessionExpiryInterval = 7200

event_id = str(uuid4())
payload = {
    "eventId": event_id,
    "deviceId": "machine01",
    "kind": "temperature_high",
    "value": 91.2,
}
client.connect("127.0.0.1", 1883, keepalive=60,
               clean_start=False, properties=properties)
client.loop_start()
try:
    if not connected.wait(5):
        raise TimeoutError("未收到成功的 CONNACK")
    # QoS 1 的完成表示发布握手结束,不表示数据库已经写入。
    info = client.publish(
        "factory/machine01/events", json.dumps(payload), qos=1
    )
    info.wait_for_publish(timeout=10)
    if not info.is_published():
        raise TimeoutError("10 秒内未完成 PUBACK 确认")
    print(f"QoS 1 已确认: {event_id}")
finally:
    client.disconnect()
    client.loop_stop()

预期输出(在 Broker 正常接收并确认发布的情况下,<ID> 是每次新生成的事件 UUID):

text
QoS 1 已确认: <ID>

这里固定 client_id 用于恢复会话,但每次执行都会创建一个新事件。生产中若同一事件因超时需要重试,必须复用已经落盘的原始 eventId 和载荷;进程重启后不能依赖 Python 进程内存保存尚未确认的消息。还应检查 MQTT 5 的 PUBACK Reason Code,区分正常确认与服务端拒绝消息。

估算积压并验证去重

假设网关每秒产生 2 条重要事件、每条 JSON 载荷约 250 B,断网 45 分钟就有 2 × 45 × 60 = 5400 条,裸载荷约 1.35 MB,还不包括队列索引与磁盘日志。可给本地重要事件队列预留至少 6000 条的容量;按 2 条/秒计算,仅能覆盖约 50 分钟,超过上限必须触发告警并启用独立的高优先级告警保留策略。补发速率若限制在 20 条/秒,恢复时仍持续产生 2 条/秒,追平 5400 条旧积压约需 5400 ÷ (20 − 2) = 300 秒。

验收时依次检查:先让平台以 QoS 1 订阅并建立持久会话,断开平台客户端后继续发布,再在 7200 秒内以原 Client ID、Clean Start = false 重连,观察 Session Present = 1 并消费允许保留的积压;然后断开发布网关,确认新事件只进入本地队列,联网后按原 eventId 补发。最后对同一个 eventId 主动投递两次,在平台数据库设置唯一键 (device_id, event_id),要求两次 MQTT 投递只形成一条业务记录。

可对照 MQTT 5.0 官方规范 与 Paho Python 2.x API 文档 核查会话属性和发布确认行为。

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

目录与阅读设置

阅读设置

17

记录一个想法

为上报选择 QoS 和会话过期策略

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

登录哪都通