看板重连就收到昨天的状态，怎样识别 MQTT 保留值的时效

2026-10-24

MQTT 新订阅收到保留消息，只能说明代理保存过这个主题的最后一条保留负载，不能证明数值刚刚采集。应同时核对 RETAIN、负载内的采样时间、接收时间和项目允许的最大年龄；没有采样时间时，先把它标为“时效未知”，不要替它补上接收时刻当采样时刻。

环境和证据范围

适用于保留消息被用来恢复温度、运行状态等看板初始值的链路。本文以 MQTT 5.0 为规范版本，年龄门限和负载字段为应用约定；MQTT 3.1.1 也不能单靠 retain 位提供数据新鲜度。需要记录采集端时钟来源，本文没有连接真实代理。

先在点表写明 sampled_at、接收时刻和可接受年龄。例如“最多30秒”是示例项目的口径，不是协议默认值。把接收时刻与采样时刻都保存，避免看板刷新后丢失原始时间。
新订阅后原样保留 topic、retain 与 payload，再计算接收减采样的年龄。先检查缺字段、时间类型和未来时间，再检查超龄；未来时间应进入时钟异常分支，不能当成最“新”的数据。
用一条正常新值、一条超龄值和一条采样时刻晚于接收时刻的样例回放。允许缓存值先显示时，要附“历史值/更新时间”，并让下一条正常采样覆盖它，不能只刷新在线图标。

合成接收时刻为1000秒，采样分别为990、900和1005秒，门限30秒。期望依次为“接受”“过期”“时钟异常”；990那条年龄10秒。另一个没有 sampled_at 的值应判“时效未知”。脚本只计算这四个结果，不模拟代理的保留消息存储。

采样时间与发送时间也应分开：网关补传旧采样时，发送时刻可能很新。如果只能获得发送时间，最多评价这条消息何时发出，不能据此证明传感值的采样年龄。记录还要注明秒、毫秒与时区格式，避免把单位差异当成长时间断流。

下载本题合成输入与预期JSON、离线只读核验脚本和现场空白记录CSV。放在同一目录，用 Python 3 运行 python verify.py，逐项计算或解析后与预期比较，失败会显示差异。

现场字段包括 topic、retain、sampled_at、received_at、age_seconds、decision。合成样例保持原样，实测另存并填写型号、版本、证据路径，未采集处留空。本地核验不代表真实设备、代理、浏览器或长期稳定性已测。

RETAIN=0也不自动等于新数据：普通发布者同样可以发送旧采样。相反，刚采集的数据即使作为保留值分发也可能仍在门限内。若整片区域都出现未来时间，先核对采集端和接收端时钟；不要靠放大门限掩盖偏差。

移交时交付每个点位的年龄门限、缺时间处理、时钟异常表现以及刷新后初始值策略。现场还要验证真实消息字段是否完整、时间单位是否一致，并保留订阅前后的脱敏原始负载。

需要接入中控时，可对照SoftControl设备联动需求核实适配范围；独立校验方法是否纳入交付需逐项约定。

核对日期：2026-10-24。规范定义与本文应用约定分开，示例门限及脚本不自动代表产品原生能力。

评论发布后会被人工复核，违规内容将被删除。

如果发表没有反应，可以前往联系我们告诉我们。