单片机与物联网 / 系统课时
整理上线前 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 值。
#!/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预期输出:
TLS_RETAINED_DELIVERY=PASS执行前先确认 Topic 允许发布、订阅和清理;所需的主机名、证书路径、账号与端口以实际环境为准。脚本的通过只证明 TLS 连接、QoS 1 发布及 Retained 订阅链路在该账号下可用,不覆盖跨角色 ACL、离线重放和业务去重,这些必须保留独立测试记录。真实密码不要写入代码仓库、CI 日志或共享终端历史。
将检查结果转换为放行决定
发布单至少附上五份证据:协议和 Topic 契约表;合法与非法访问的 ACL 测试;稳态和峰值压测曲线;断线、会话过期与幂等恢复记录;告警触发和通知演练结果。监控应持续关注连接数、异常 CONNACK、发布接收与投递速率、队列存储量、丢弃计数以及业务消费延迟,并标明采样周期。
放行标准要写成数字与条件,例如“目标峰值负载运行 15 分钟无非预期丢弃、重连后 30 秒内清空测试积压、未授权访问成功次数为 0”;数值需按项目 SLO 和设备行为批准,不是通用标准。若出现跨租户授权、重复执行危险命令、积压不受控或告警缺失,应停止发布。回滚单还须包含上一版配置、证书与 ACL 的恢复方法以及回滚后重新执行的冒烟测试,才能完成上线签字。