一、开篇:链路恢复那一刻,层号倒着走了一遍
地下泵房巡检,回传链路中断了一段时间。运维在平台上看,人员层号停在中断前那一层,颜色转为灰色离线;链路恢复后,终端把缓存的一批观测一次性补上来,平台上的层号却按缓存顺序从旧到新重新走了一遍,中间还短暂回到几层之前。人在现场早已上到地面,界面显示的却是二十分钟前的楼层。本文拆的是这条分支:离线期间的层号怎么存、怎么补、恢复后历史轨迹与当前实时状态怎么分开。
这不是判层算法算错了,而是两条数据通路被混在一起:一条是补传的历史观测,一条是当下的实时状态。离线让它们同时到达,若没有明确的合并规则,界面就会把回放当成现实。
二、问题定义:离线把「过去了多久」变得不可见
常规链路里,观测按采集顺序陆续到达,平台把新到的一帧当作当前状态,层号随时间向前推。离线打破了这条假设:终端继续采样、继续判层,但数据留在本地;平台侧的层号保持不变,且没有任何信号说明这份不变是「人没动」还是「链路断了」。两者在界面上长得一样。
四色状态提供了部分答案:灰色离线、绿色在线静止、蓝色在线运动、红色有未处理报警。灰色只说明链路不可用,不能说明人员在离线期间是否移动过。若业务侧把灰色的层号当作实时位置使用,就会把一段过期信息读成现状。
恢复瞬间还有第二个问题:缓存观测往往按批次到达,批内顺序、批次之间的顺序、以及与恢复后新采集观测的顺序,三者未必一致。若服务端按抵达顺序写状态,层号会出现倒退、跳变、重复。
第三个问题关乎责任边界。离线期间终端是否自行判层、判层结果是否带层号、恢复后是否允许覆盖平台已有状态、补传的历史是否要重新触发业务规则,都需要在方案里定清楚。含糊处理的表现通常是:轨迹看起来补齐了,告警记录却多了一批不该有的事件。
三、技术原理:把回放通路与实时通路分开
可以类比行车记录仪与导航画面:记录仪负责把过去一段路完整存下来,事后可回放;导航画面只显示当前位置。两者可以用同一批原始数据,但不能共用同一个显示状态。离线恢复时该做的是「先把记录仪补完,再把导航切回当前」,而不是让导航把旧录像播一遍。
术语先解释。离线状态指终端与平台之间链路不可用、观测暂存本地的阶段;本地队列是端侧按时间顺序保存待补传观测的缓存结构;采集时刻是观测产生时的时间标记,抵达时刻是服务端收到它的时间标记,两者在补传场景里差别明显;单调序号是端侧为每帧观测分配的只增编号,用于去重与排序;幂等指同一批数据重复上报不产生重复结果;状态快照是某一时刻的层号与置信标记;回放是按采集时刻重放历史观测以补齐轨迹;实时对齐是用恢复后的新观测把当前层号校正到真值。
原理链路(文字示意):链路中断 → 端侧进入离线态,观测带采集时刻与单调序号写入本地队列,同时维护本地层号状态快照 → 链路恢复 → 按序号断点续传,分批补传并做幂等去重 → 服务端按采集时刻排序回放,补齐历史轨迹与业务记录,不改写当前实时层号 → 恢复后的新观测进入实时通路,与当前状态做对齐校正 → 界面切回实时层号。回放通路与实时通路在数据写入与展示两个层面都分开。
这里有个关键取舍:离线期间端侧要不要判层。若只存原始观测、端侧不判层,恢复后由平台统一回放计算,逻辑集中、端侧简单,代价是端侧没有任何可展示的层号,本地提示与现场处置用不上。若端侧自行判层并存快照,本地可用性更好,代价是要处理端云参数版本不一致、快照与回放结果不一致的合并问题。两条路都能成立,选哪条取决于现场是否需要离线可见。
另一个取舍是补传粒度。逐帧补传能让服务端较早看到历史,但链路开销大、重复上报概率高;整批补传省链路,却让恢复瞬间的写入压力集中。工程上常见的是按序号分段批量补传,服务端对每段做幂等确认,失败只重传该段。

图1 断网续传与离线判层状态一致性原理链路拓扑:链路中断后观测带采集时刻与单调序号写入本地队列并维护层号状态快照,恢复时按序号断点续传、幂等去重,服务端按采集时刻排序回放补齐历史轨迹,恢复后的新观测走实时通路校正当前层号。
四、方案对比:四种处理离线数据的路线
把常见做法摊开看,差别主要在「端侧是否保留状态」与「恢复后历史与当前是否分道」。下表沿用本系列的五路线对照格式,把断网续传与离线判层状态一致性作为一条独立分支单列,其余四条是工程中会被拿来替代或配合的既有路线。

表1 五种参与楼层定位的技术路线对照:技术分支、在楼层定位中的角色、输出粒度与精度量级、部署要点与主要约束(精度量级以厂商资料为准;断网续传与离线状态一致性作为链路恢复分支单列)。
丢弃离线数据、恢复后只看新观测,实现成本极低,界面也不会倒退。代价是轨迹出现一段空白,事后复盘无法还原离线期间发生过什么。若业务对轨迹完整性没有要求,这条路可以成立,但要把「有空白」明确写进交付说明。
离线数据全部当作实时状态顺序写入,能让轨迹看起来连续,却把回放当成现实,正是开篇那类层号倒退的来源。它还容易连带产生一批历史告警,因为业务规则看到的是一串「新到」的状态变化,而不是一段已过去的轨迹。
只做端侧本地判层、不回传历史,现场可用性不错,平台侧却永远缺一段。跨班次、跨设备的统计与审计会因此出现缺口。端侧判层与平台回放并不互斥,把两者都保留并明确各自用途,通常比二选一稳。
五、技术细节:队列、去重与状态切换
本地队列要带三类字段:采集时刻、单调序号、观测内容与层号快照。缺单调序号时,同一批数据重传只能靠时间去猜重;缺采集时刻时,回放无法还原先后顺序。序号宜由端侧连续分配,不依赖网络,恢复后从服务端已确认的位置继续。
队列容量与溢出策略必须显式约定。离线时长超出缓存能力时,是保留较新的一段、保留较旧的一段,还是按层号变化点抽稀,三种策略对复盘的价值不同。容量数值以厂商资料为准,本文不给具体数字;但「满了以后怎么办」必须在方案里写死,不能留给默认行为。
本地时钟漂移是回放的隐性误差源。离线期间端侧时钟可能与平台时基逐渐偏离,采集时刻因此整体偏移,回放时与门禁、视频等外部事件对不上。可在恢复时用一次带时基信息的心跳做校正,并把校正量记入日志;若无法校正,回放结果应标注时间不确定,而不是假装精确。
幂等去重的键宜用「设备标识 + 单调序号」,而不是只靠采集时刻。同一时刻可能产生多帧观测,不同批次也可能重复上报同一帧;时刻相同不等于内容相同,序号相同则基本可以判定重复。服务端对已确认序号应返回成功但不重复写入。
回放通路要明确标注数据性质。补传观测写入历史轨迹与统计记录时,应带「补传」标记与原始采集时刻;业务规则若基于层号变化触发,宜在回放阶段按离线期间的真实时序计算,但不要把回放结果推成当前状态。这一段与实时对齐是两件事。
实时对齐的时机值得单独定:链路恢复后先等一小段新观测,用连续稳定的层号覆盖界面上的旧值,再切回实时展示。若一恢复就把界面切到实时通路,而又没有新观测可用,界面上仍会是离线前的层号,只是标签从灰色离线变成了在线,反而更隐蔽。
平台侧的报警行为要对齐事实:报警均只会在平台显示,设备不会有反应;报警推送顺序为 web → 微信 → 短信 → 邮件(邮箱需客户定制),任一种成功即停止。离线期间产生的状态变化若需要通知,应由回放阶段按业务规则判断是否补发,并明确补发的时效;把二十分钟前的层号跳变当作当下事件推送,是常见的一类误报来源。
监控数据归属也影响回放写入:监控数据基于监控对象(人员),修改绑定设备后原数据依然保留,未绑定监控对象的设备为库存设备、不记录数据。补传数据应按采集时刻所属的人员归属写入,而不是按恢复时刻的绑定关系;否则设备换绑之后,历史轨迹会被挂到新对象名下。
与平台建模的衔接同样要留意:楼层定位部署流程为五步——添加基准站 → 配置设备参数 → 现场部署验证 → 添加建筑与楼层 → 开启三维显示查看定位;系统按实际层高逐层添加楼层并自动生成各层海拔区间,填写地平海拔(首层地面海拔)并把地平层指定为首层。若离线期间层高区间或基准参数发生过变更,回放应按观测产生时的参数版本解释,别用恢复后的新配置重算旧高度。
端云参数版本不一致是另一处常见坑。端侧判层用的门限、层高区间、滞回参数若与平台当前版本不同,快照层号与回放结果会对不上。合并规则宜写清楚:以哪一侧为准、差异如何标记、是否需要重算。参数版本随配置一起留存,比事后靠日志推断可靠。

图2 楼层定位多分支融合拓扑:主干为气压海拔(层高趋势),卫星定位(室外锚点)、蓝牙信标(平面 XY)、断网续传(回放与实时对齐分道)、惯性计步(盲区补位)作为分支汇入融合解算层,在三维建筑地图输出人员实时楼层归属。
验收建议做四类用例:短时离线后恢复(轨迹应补齐且当前层号不倒退)、补传批次重复上报(不应产生重复记录)、离线期间跨多层移动(回放应按采集时刻还原,界面仍显示恢复后的真值)、设备换绑后补传(历史应归属采集时刻的监控对象)。另测一次超长离线触发队列溢出,确认策略确实按约定执行。
运行期宜把三项指标放在一起看:补传丢失率、回放与快照层号不一致率、恢复后当前层号收敛所需的新观测数。单独看其中一项容易得出片面结论。这些指标随链路质量与离线时长变化,宜按场景分组统计。
关于数值,本文不给具体数字:队列容量、离线时长上限、补传批次大小、时钟校正精度都随设备与链路条件变化,统一以厂商资料与现场实测为准。我不确定某类终端是否支持按序号断点续传,实施前应向厂商确认,不要依据本文自行推断。
回放日志宜单独留存:补传批次编号、起止序号、采集时刻范围、幂等去重命中数、按哪一版参数解释、回放结果与当前层号的差异。审计或事故复盘时,这份记录能说明平台在离线期间到底知道什么、什么时候才知道,避免把补传完成时间误当成事件发现时间。
离线时长宜分组统计。短时中断、跨越一次层间移动的中断、长到触发队列溢出的中断,对轨迹完整性与当前层号收敛的影响不同,用同一个指标平均掉会掩盖问题。按组分别看补传丢失率与收敛所需新观测数,调整队列容量与批次大小时才有依据。
六、局限与边界
断网续传解决的是数据可达性与状态语义,不解决观测质量。离线期间气压基准漂移、信标被邻层扫到、层高区间配错,这些错误照样会被完整缓存并回放回来。回放让错误更完整,不会让错误更正确。
它也无法弥补实时性。离线期间的层号对平台而言始终是未知的,回放能补齐历史,却不能把当时的实时位置追回来。若业务需要在链路中断期间掌握人员楼层,靠补传无能为力,需要独立的本地呈现或另一条回传通路。
另一条边界来自安全生产表述。系统给出的层号与报警是辅助信息,不改变事故是否发生,也不替代现场管理制度。离线状态必须被明确识别,不能把灰色离线下停留的旧层号当作实时位置用于处置判断;这一约束比补传逻辑本身更要紧。
跨设备换绑、跨班次交接、人员与标签临时分离,都会让「这批补传数据该挂给谁」变复杂。规则宜按采集时刻归属,并在交接记录里留出人工核对入口;完全自动化地在恢复瞬间重算归属,往往会把责任边界算乱。
还有一点需要如实说明:本文讨论的是通用工程口径,具体补传协议、幂等实现、参数版本管理方式需要以厂商资料为准;我不确定某个平台内部是否已经把回放通路与实时通路分开,实施前应向厂商确认,避免重复处理或相互抵消。
七、结论
回到开篇:链路恢复那一刻层号倒着走了一遍,问题不在判层,而在补传的历史观测被当成了当前状态。断网续传与离线判层状态一致性这条分支做的事,是让观测带采集时刻与单调序号进本地队列,恢复时按序号断点续传、幂等去重、按采集时刻回放补齐历史,再让恢复后的新观测走实时通路把当前层号校正到真值。
给一个可执行的判断标准:验收时做一次离线跨层移动再恢复,检查两件事——历史轨迹按采集时刻完整还原、界面当前层号直接落在恢复后的真值且不倒退;两者只要有一项没做到,就说明回放通路与实时通路还混在一起。另补一次重复上报,确认幂等没有产生重复记录。
队列容量、批次大小与时钟校正精度没有通用解,以厂商资料与现场实测为准。离线期间平台上的层号是过期信息,把这一点显式表达出来,比把界面做得看起来连续更诚实。