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

整理上线前 MQTT 检查项

整理上线前 MQTT 检查项

将 MQTT 上线准备从“能连通”变成可以签字的验收清单:逐项确认消息契约、安全边界、容量余量、断线恢复与监控告警,再运行一次端到端冒烟测试。最终得到的是带证据、阈值和回滚条件的发布判断,而不是只记录配置已填写。

学习目标

  • 将 MQTT 关键参数对应到可验证的通过标准。
  • 用真实容量算例检查 Broker 的上行、扇出和离线队列压力。
  • 执行 TLS 下的发布、保留快照与订阅验收,并明确阻断上线的条件。

锁定消息与会话契约

先在发布记录中固定 Broker 版本、客户端协议版本、Topic 命名约定和每类消息的 QoS、Retained、Expiry 设置。以测试设备 motor-07 为例,下面的值是待验证的项目约定,不是 MQTT 强制默认值。

消息 示例 Topic 后缀 建议验证的行为
遥测 telemetry QoS 1、非 Retained,重复投递按 eventId 去重
最新状态 state Retained,新订阅端应立即得到最后一份快照
设备在线状态 presence 上线消息和遗嘱离线消息使用一致 Topic,并核对 Retained
设备命令 command QoS 1、非 Retained,携带 requestId,超时或重投递不重复执行

同一设备的完整 Topic 必须有受控租户前缀,设备只能写自己的遥测、状态和响应主题,服务端按角色订阅或下发命令。对于 MQTT 5,还应记录 Keep Alive、Session Expiry Interval、Message Expiry Interval、Receive Maximum 和 Maximum Packet Size 的协商结果;不能只看客户端期望值而忽略 Broker 实际限制。

核实安全与容量门槛

安全验收同时做正反向测试:合法证书和账号可以连接,错误证书、错误密码及跨设备 Topic 操作必须被拒绝;公网监听禁止匿名访问,TLS 证书的域名、信任链和到期提醒均须验证。生产场景使用最小权限 ACL,并使 Client ID 在有效会话范围内唯一,避免设备互相踢下线。

容量预算要计算投递扇出,而非只计算设备上报。假设有 5000 台设备每 5 秒上报一条 256 B 遥测,则上行约 1000 条/秒、256 kB/秒 负载;平均每条匹配两个订阅者,下行约 2000 次投递/秒、512 kB/秒 负载。上述数据未计 MQTT/TCP/TLS 头、QoS 确认、重连和 Retained 开销,压测至少分别覆盖稳态与成批重连峰值。

预设队列上限,如 max_queued_messages 与 max_queued_bytes,再证明慢消费者和离线会话不会无限占用内存。以 30 分钟断线、每秒 2 条、每条 256 B 为例,单设备可能积累 3600 条、约 922 kB 纯负载;若限额不足,必须明确允许丢弃还是改用业务补拉,不能声称 QoS 1 等于永久保存。

验证断线恢复与业务幂等

恢复验收使用同一个固定 Client ID 和非零 Session Expiry:连接并订阅、断网、离线期间发布 QoS 1 消息、恢复连接并核对补发。再测试过期消息不会执行、已确认过的命令按 requestId 去重,以及 Broker 重启后是否仍能恢复预期会话;持久化结果取决于服务端实际配置,不能从协议版本推断。

连接重试可用 1、2、4、8 秒 的指数退避并加入抖动,避免大批设备同步重连。遗嘱只能用于非正常断开时的离线通知,不应把它当作所有正常停机的替代;管理端应按消息时间戳区分最新快照与过期状态。

执行 TLS 冒烟验证

在预发环境准备可校验的 CA 文件、已授权的测试账号及独占 Topic release-check/motor-07/state,安装 Mosquitto 客户端工具。先通过受控密钥存储向终端注入 MQTT_HOST、MQTT_USER、MQTT_PASS、MQTT_CA,可选设置 MQTT_PORT,默认 8883。下面脚本先发布 QoS 1 Retained 快照,再用新连接验证能读回完全一致的负载,退出时清除该测试 Topic 的 Retained 值。

bash
#!/usr/bin/env bash
set -euo pipefail
: "${MQTT_HOST:?required}"
: "${MQTT_USER:?required}"
: "${MQTT_PASS:?required}"
: "${MQTT_CA:?required}"
PORT="${MQTT_PORT:-8883}"
TOPIC='release-check/motor-07/state'
PAYLOAD='{"online":true,"schemaVersion":1}'
COMMON=(-h "$MQTT_HOST" -p "$PORT" --cafile "$MQTT_CA" -V mqttv5 -u "$MQTT_USER" -P "$MQTT_PASS")

# 只删除本次测试 Topic 的保留快照,避免污染实际设备状态。
cleanup() {
  mosquitto_pub "${COMMON[@]}" -q 1 -r -n -t "$TOPIC" || true
}
trap cleanup EXIT

# Publish 成功之后再建立新订阅,专门验证 Retained 恢复。
mosquitto_pub "${COMMON[@]}" -q 1 -r -t "$TOPIC" -m "$PAYLOAD"
RECEIVED=$(mosquitto_sub "${COMMON[@]}" -q 1 -t "$TOPIC" -C 1 -W 5)
if [[ "$RECEIVED" == "$PAYLOAD" ]]; then
  printf 'TLS_RETAINED_DELIVERY=PASS\n'
else
  printf 'TLS_RETAINED_DELIVERY=FAIL\n' >&2
  exit 1
fi

预期输出:

text
TLS_RETAINED_DELIVERY=PASS

执行前先确认 Topic 允许发布、订阅和清理;所需的主机名、证书路径、账号与端口以实际环境为准。脚本的通过只证明 TLS 连接、QoS 1 发布及 Retained 订阅链路在该账号下可用,不覆盖跨角色 ACL、离线重放和业务去重,这些必须保留独立测试记录。真实密码不要写入代码仓库、CI 日志或共享终端历史。

将检查结果转换为放行决定

发布单至少附上五份证据:协议和 Topic 契约表;合法与非法访问的 ACL 测试;稳态和峰值压测曲线;断线、会话过期与幂等恢复记录;告警触发和通知演练结果。监控应持续关注连接数、异常 CONNACK、发布接收与投递速率、队列存储量、丢弃计数以及业务消费延迟,并标明采样周期。

放行标准要写成数字与条件,例如“目标峰值负载运行 15 分钟无非预期丢弃、重连后 30 秒内清空测试积压、未授权访问成功次数为 0”;数值需按项目 SLO 和设备行为批准,不是通用标准。若出现跨租户授权、重复执行危险命令、积压不受控或告警缺失,应停止发布。回滚单还须包含上一版配置、证书与 ACL 的恢复方法以及回滚后重新执行的冒烟测试,才能完成上线签字。

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

目录与阅读设置

阅读设置

17

记录一个想法

整理上线前 MQTT 检查项

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

登录哪都通