单片机与物联网 / 系统课时
给过期消息设置生存时间
给过期消息设置生存时间
阀门离线时,Broker 可能暂存发送给它的开启指令;如果设备十几秒后才恢复,旧命令就不应再执行。MQTT 5 的 Message Expiry Interval 可为消息设置以秒计的存活期限,使 Broker 到期丢弃尚未转发的消息。本课通过离线订阅队列验证一条只在 5 秒内有效的指令。
学习目标
- 说明 Message Expiry Interval 的计时起点与适用范围。
- 让 QoS 1 命令进入持久订阅会话,并验证超过有效期后不再补发。
- 区分消息过期、会话过期与应用层的命令有效性校验。
消息的有效时间由谁计算
发布端在 MQTT 5 PUBLISH 属性中设置 Message Expiry Interval=5,表示 Broker 收到消息后最多保留 5 秒。若订阅端此时离线,Broker 可以把匹配的 QoS 1 消息放入其会话队列;超过 5 秒仍未转发时,消息必须被删除,重连也收不到。
如果订阅端在第 3 秒恢复,Broker 可以转发该消息,并将剩余存活时间(约 2 秒)带给 MQTT 5 接收端;不会从转发时重新计满 5 秒。消息已经交付给设备后,该属性不能撤回设备收到的指令。保留消息也可以设置到期时间;这与是否启用 retain 是两回事。

建立离线队列并发布限时命令
准备支持 MQTT 5 的本地 Mosquitto Broker 和命令行客户端。先启动一个固定 Client ID 的订阅端,-c 表示恢复会话,-x 60 使断开后的会话最多保存 60 秒;订阅 QoS 与发布 QoS 均为 1,Broker 才能在离线期间保留待交付命令。
mosquitto_sub -V 5 -h 127.0.0.1 -i valve-01 -c -x 60 -q 1 -t 'devices/valve-01/cmd' -v预期结果:订阅成功后命令保持等待;确认已连接,再用 Ctrl+C 结束该终端进程,Broker 中的订阅会话仍可在设定期限内恢复。
在订阅端离线期间立即运行发布命令,其中 -D PUBLISH 是 Mosquitto 客户端设置 MQTT 5 PUBLISH 属性的真实参数形式:
mosquitto_pub -V 5 -h 127.0.0.1 -q 1 -t 'devices/valve-01/cmd' -m 'OPEN' -D PUBLISH message-expiry-interval 5预期结果:命令成功执行时默认没有终端输出;Broker 暂存这条指令,但有效期只有 5 秒。不要把命令行安静退出误认为阀门已执行。
等待 7 秒后,在会话尚未过期时,用同一 Client ID 和相同订阅参数重连:
sleep 7
mosquitto_sub -V 5 -h 127.0.0.1 -i valve-01 -c -x 60 -q 1 -t 'devices/valve-01/cmd' -v预期结果:订阅端继续等待,不会补收到先前的 OPEN。为验证正向分支,可以重复实验并将过期值改为 30 秒、在 5 秒内重连;此时应收到 devices/valve-01/cmd OPEN。不要用已经过期的旧消息判断是否订阅成功。
避免把会话保留误当作指令保鲜
Session Expiry Interval=60 保护订阅关系及可保存的会话状态,Message Expiry Interval=5 只约束单条消息;前者更长并不允许 Broker 重新发送已过期的指令。MQTT 3.1.1 没有 Message Expiry Interval,使用此属性必须选择 MQTT 5,并确认 Broker 支持。