Wi-Fi 指纹判楼层：AP 拓扑、跨层相似性与指纹更新

口径说明：文中平台规则、功能名称与版本差异均取自某人员定位平台使用手册原文；覆盖半径、衰减幅度、扫描周期、相似度阈值、精度量级等一律为行业通用经验值，只说明量级，不代表任何产品参数。

一、引言：重铺了网线、换了路由器，判层是悄悄错的

某写字楼做了一次在网络侧看来很普通的改造：重铺三层网线、换掉老化路由器、五层补两台面板 AP，顺手把信道从 6 挪到 1。改造半小时完成，网络监控全程正常，也没人通知定位系统。两周后的运维例会上开始抱怨：人明明在三层的工牌被判到四层，早高峰明显比夜间差——但翻定位侧日志，没有任何报错。

最关键的就是这句“没有报错”。Wi-Fi 指纹不是配置一次就永久有效的静态模型，它的输入是现场射频拓扑的投影，属于动态环境信号：指纹库记住“某个位置周围的信号长什么样”，而信号的样子由 AP 的位置、数量、发射功率、信道与楼板材质共同决定。拓扑一变，指纹与现场的对应关系就开始腐坏；而匹配算法永远会给出距离最近的参考点——它不会拒绝，只会把不可信的结果照常输出。错误于是变得沉默。

本文不讲最近邻如何算距离，只讲这条路线真正的工程难点：拓扑变更引发的指纹衰减如何监测、跨层相似指纹靠哪些特征区分、在线匹配如何输出不置信并自动降级到信标与气压。这三件事做好，指纹才是可运维的方案；做不好，它就是一张会慢慢过期、却不提示过期的地图。

二、问题拆解：指纹的四种失效模式

先把“判层变差”这个笼统症状拆开。失效模式不同，对策完全不同；混在一起治理，会把噪声直接写进模型。

拓扑变更型。AP 增删、搬迁、功率或信道调整。表现为突变，影响集中在被改动 AP 的覆盖邻域，错误通常从“跨一层”开始。触发方往往是网络运维而非定位系统，若两者之间没有变更通知链路，引擎只能靠自动监测抓变更，而抓取本身就意味着滞后的两周。

环境构造型。隔断重划、货架移位、吊顶改造。AP 一个没动，传播路径却变了。表现为缓慢漂移，某些参考点的准确率沿周尺度下滑，很容易被误归因为终端电量不足。

负载与遮挡型。人体吸收、防火门开合、早高峰的电梯厅。表现为短时波动与昼夜周期，本身不是模型错误，处理原则恰恰是不要更新指纹库。

终端异构型。建库终端与在线终端的芯片、天线、姿态不同造成系统性偏移，表现为整栋楼一起偏，属于标定问题。

四类对应四种动作：变更型靠感知加增量重建，构造型靠漂移监测加定期重采，负载型靠时段过滤不入库，异构型靠入库前校准加只用统计量特征。分类的价值是给监测指标定语义：同样是相似度下降，第一种要立刻重建，第四种要重新标定，第三种只需把样本挡在门外。

三、技术原理：从扫描列表到楼层标签

按“信号来源 → 测量 → 解算 → 误差”四段看这条链路。

信号来源。一次扫描可见的发射源分三类：本层专用 AP、本楼其他楼层与公共区域 AP、从邻楼泄漏进来的 AP。判别价值恰恰来自三者混合——专用 AP 提供可控的层内签名，邻楼泄漏 AP 提供“这一层恰好能看到哪些外部网络”这种几乎不可复制的组合，指纹跨建筑不可迁移的根因也在这里。判层可行靠的是垂直方向的衰减梯度：穿过一层楼板带来的强度下降，往往比在同一层平面上走十几米更明显（量级属行业通用经验值）。5 GHz 的跨层区分度通常比 2.4 GHz 更好，但覆盖半径更小。

测量。终端得到的不是坐标，而是一张列表：BSSID、SSID、频段与信道、RSSI。同一台双频 AP 会呈现为两个 BSSID，需按台账归并成一个物理 AP。扫描受占空比限制，一次未必收齐全部可见 AP，这类漏检既是重要误差来源，也是“环境真的变了”与“只是没扫到”之间最难区分的一点。

解算。把扫描列表转成以 AP 台账为轴的定长向量，未观测的维度填哨兵值，再与库中参考向量比对。工程上三条路径：加权最近邻取最近的 K 条参考指纹按距离倒数加权投票楼层，K 过大被远端点拖累、过小被噪声点绑架；概率匹配为每颗 AP 在每个参考点保留直方图或高斯模型，算似然后取峰值，抗抖更强，代价是库体积与算力；楼层聚合特征不逐条比对整层参考点，而是先按层聚合出层签名——可见 AP 集合、可见数量、强度分布的统计量——在线先比层签名再进层内精配，既省算力，又天然压住同层水平移动的干扰。度量上，曼哈顿距离对单颗 AP 被临时遮挡不会被平方项放大，通常比欧氏距离稳。

误差。跨层相似性最难，成因有三：电梯井、中庭、开放楼梯形成垂直射频通道，上下几层看到同一批 AP；楼宇边缘与窗边同时收到邻楼信号，签名趋同；若以 SSID 为轴构造指纹，同一 SSID 在多层复用会让向量退化到没有区分度。此外可见性抖动来自扫描占空比与多径，姿态偏差来自人体遮挡。结果是错误并非均匀分布，而集中在垂直开敞空间、楼宇边缘与楼层交界处。

四、分支对比：四条路线在判层链路里各补哪一段

读这张表不是去找精度数字，而是看链路里哪一段会断。Wi-Fi 指纹的长项是复用现场设施、直接给出离散层 ID，短项是运维负担最高——它没省掉成本，只是把一次性建设换成长期治理。蓝牙信标回答的是“在楼层平面的哪里”，不是“在第几层”；气压给连续层高趋势且与射频无关，但需基准与温漂补偿；卫星高程在深楼层与内区直接失效。

五、系统架构：五层链路与治理抓手

终端采集层。工牌、手环或手机按占空比扫描并上报列表。终端异构问题在这一层产生，也最好在这一层收敛：同批次统一固件、扫描参数与佩戴方式，把标定问题挡在数据入口。

链路与接入层。上行通道、时间戳对齐与批次口径。判层时序敏感，链路乱序会让监测的时段指标失真。平台的数据核算本身是批式的：默认明天处理今天数据，检测到跨 0 点的会自动改成后天处理今天数据；指纹侧监测沿用同一口径，才不会得出“同一份数据两种结论”。

定位引擎层。三个模块：特征构造（台账归并、向量填充、层签名生成）、匹配解算（加权最近邻或概率法）、置信与仲裁（置信度计算、四态输出、降级决策）。AP 台账与指纹库版本管理也放在这一层，它是整套治理的抓手——没有版本就没有回滚。

业务平台层。判层结果进入位置数据、签到与围栏事件。归口要提前理清：组织结构最高支持 4 个层级，建筑、楼层、指纹库与设备分组按此划分责任边界。平台所有监控数据都基于监控对象（人员），修改绑定设备后原数据依然保留，未绑定监控对象的设备为库存设备、不记录数据——这意味着判层指标必须把两类样本分开统计，否则库存设备产生的扫描数据会稀释漂移指标，灵敏度看似提高，实际只是样本构成变了。

可视化与事件层。三维建筑地图呈现楼层归属，监控图元颜色为灰色离线、绿色在线静止、蓝色在线运动、红色有未处理报警；轨迹回放与轨迹比对用于复核判层错误。围栏侧规则原文：围栏分为 3 种：安全围栏、警示围栏、危险围栏；围栏优先级 0 最高，15 最低。层 ID 抖动会直接放大成进出围栏的报警抖动，所以判层必须带置信度门槛再参与事件判定。报警推送方式共 3 种：web、微信、短信，推送顺序为 web→微信→短信→邮件（邮箱需要客户定制），只要节点上有一种推送成功即停止推送；且各类报警均只会在平台显示，设备不会有反应。

六、关键实现：衰减监测、特征选择、置信与降级

6.1 指纹衰减监测与增量更新

监测的前提是有台账：把现场 AP 的 BSSID、安装位置、所属楼层、信道、发射功率、变更历史登记成可查询的台账，并争取一条网络侧的变更通知链路——哪怕只是“改动后在工单里知会定位运维”这一条约定，也能把大部分突变从两周后人肉发现变成当天定位。

指标分两级。层签名级响应快：统计各层近期观测的可见 AP 集合与库中层签名的集合相似度，以及整层平均 RSSI 偏移，任一项持续越限就把该层标记为疑似衰减。参考点级用于定位局部坏点：对每条参考指纹维护近期观测窗口，集合相似度与向量距离同时越限才判定衰减。双指标不可省：集合相似度衡量“看到的 AP 变了没有”，向量距离衡量“强度变了多少”；只看后者会把人群遮挡误判成拓扑变更，只看前者会把功率与增益调整整批漏掉。阈值与窗口长度属现场调参项，起步量级按行业通用经验值设定。

确认衰减后走增量更新而非全库重采：范围取被改动 AP 的覆盖邻域再外扩一圈，并包含上下相邻层的交界处。流程必须有影子库——新采指纹先构成候选版本，与主库并行运行若干批次，比对判层一致率与置信度分布，达标再切换，切换前保留上一版本以便回滚。两条纪律单独强调：低负载时段的样本要单独打标，夜间空场采集的 RSSI 系统性强于白天，不标记就会把时段差异写成空间差异；不做在线自适应直接回灌主库，那等于让正在腐坏的模型自我强化，再也找不回原始基线。

6.2 跨层相似指纹的特征选择

跨层相似是固有属性，要点是把“判层”与“判层内位置”分开优化。

第一，身份键用 BSSID 不用 SSID：同一 SSID 在多层复用是常态，以 SSID 为轴构造向量会把不同层的签名折叠成同一个。第二，把不可见当成特征：某层看不到某些 AP 本身就是签名，零维与哨兵维要参与比较——只算非零维会让“扫得少”看起来像“很像”。第三，引入跨层泄漏计数：统计向量里属于其他楼层的 AP 数量与强度分布，它兼具区分正常层与标记过渡区两重用途。第四，双频并用并给 5 GHz 更高权重。第五，聚合统计优先于绝对值：层签名用分位数、均值差、分布形状构造，以抵抗终端天线增益偏移。第六，给过渡区建独立标签：对电梯厅、中庭、开放楼梯单独布置过渡参考点，允许输出“过渡中”——把过渡态硬塞成确定层，是层跳变与围栏误报的主要来源。

6.3 置信度输出与降级仲裁

匹配必须输出可解释的置信度，建议四个分量：最优与次优候选的相对差距、本次扫描相对该参考点的 AP 缺失比例、该参考点与所在层的近期衰减指标、在线终端与建库终端的一致性标记。后两个最常被省略，而它们恰恰是“判层沉默出错”唯一的暴露途径。

据此给出四态：确定层、候选层（两个并列附权重）、过渡中、不置信（拒绝给出层 ID）。四态不是显示装饰，下游必须按状态分支：候选层时不生成围栏事件，过渡中时冻结层归属并保持上一层，不置信时进入降级。

降级顺序按证据独立性排列。第一级用气压趋势——它的观测与射频拓扑无关，恰好是指纹失效时的独立证据，可用连续层高趋势把候选层二选一压掉；第二级用信标定位，把结果落到已登记的楼层平面点位上，平台侧按 MAC 地址登记蓝牙定位信标（例如 ff:10:00:1b:9c:f4），设备开启信标扫描后监控中查看到的定位方式会变为信标定位；第三级退到离散的事后视图，即楼宇进出记录与楼层停留统计，它们能回答某人去过哪层、待了多久，但属于事后统计，用于正在发生的处置时延不够。每次降级都要写审计字段：判层依据、置信度数值、降级原因，运维只有靠这些字段才能区分“网络又改了”与“终端该换电池”。

判层的下游常是位置类任务。签到点支持地图坐标点、NFC 标签、信标、楼宇（可指定楼层）、电子围栏，其中楼宇点位可指定楼层，因而置信度不足时，任务签到应回落到 NFC 标签或信标这类强离散证据。手册的版本差异也印证这个取向：标准版只支持 NFC 标签点位签到，不支持区域面覆盖，覆盖率统计为旗舰版能力——面覆盖类判定依赖密集连续的位置观测，用易漂移的连续信号去做覆盖考核，风险会被成倍放大。

6.4 采集边界：最小必要与脱敏

指纹采集天然会记录“这个人路过哪些网络”，属于必须收敛的数据面。可执行边界有四条：只保留 BSSID、RSSI、时间戳与采集点标识，不保留 SSID 明细；轨迹与指纹按监控对象归口，未绑定监控对象的设备不记录数据；判层的运维统计只用聚合后的层 ID 与置信度分布，不下钻到个人连续轨迹；跨组织访问必须经授权，厂家和经销商不能直接查看终端用户的数据，如果需要查看需要得到终端用户的授权。这既是隐私约束也是算力约束：层签名级监测能实时跑，正是因为输入已脱敏到聚合维度。

七、典型问题：现象、原因与解决

AP 搬迁导致指纹漂移。现象：错误集中在某一楼层及其上下相邻层，夜间与白天差别不大，模式稳定重复——同一工位每天都被判到同一层。原因：搬迁后的 AP 仍在台账里，新位置的向量与旧指纹构成“同名不同位”的混淆，匹配算法照旧输出，只是输出的是搬迁前的空间关系。解决：台账与工单联动，改造前先标记受影响参考点为待重采；改造后按邻域增量重采并走影子库切换；切换期间临时提高受影响层的置信度门槛，宁可不输出也不要错输出。

密集办公区同 SSID 混叠。现象：多层判层结果互相跳，相邻层尤甚；把 A 栋建好的库拿到 B 栋做迁移测试，大面积失败。原因：以 SSID 为身份键，或多栋楼共用同一套命名规范，向量在构造阶段就被折叠，区分度在建库时已经丢失。解决：身份键一律用 BSSID 并按台账归并双频；把邻楼泄漏 AP 当作有效维度保留而不是当干扰剔除；AP 密度确实不足的区域，退化为只判楼层区间不判单点，层归属交给气压或信标兜底。
终端扫描周期与功耗。现象：拉长扫描间隔以省电，判层时延随之变长，人上下电梯后楼层归属迟迟不变，围栏事件跟着滞后；缩短间隔，电池又撑不过一个班次。原因：占空比过低会抬高 AP 缺失率，缺失率上升直接压低置信度并频繁触发降级，表面像算法不稳，实际是数据量不够。解决：把频度设计成事件驱动而非固定周期，静止时降频，检测到水平位置或气压趋势变化时升频，过渡态单独设短时加密窗口；判层指标按扫描频度分层统计。

八、选型建议

其一，现场 AP 密度足够、网络拓扑受控、且存在明确的变更通知链路，Wi-Fi 指纹适合承担层 ID 判别。三条里变更通知链路是决定性的那一条：没有它，长期判层准确率实际上取决于网络部门改拓扑的频率，而不是算法水平。

其二，垂直开敞空间多、楼层边界业务敏感（救援调度、区域准入、责任认定），不要让指纹单独承担判层：用气压做连续层高趋势，用信标或近场标识做强离散证据，指纹只做加速与交叉验证；同时把四态输出打通到事件层，让“不确定”能被业务正确地表达为“不确定”。

其三，单层厂房与露天作业面不需要判层；深内区与地下楼层里卫星高程无效，只能依赖设施化的信标或指纹，此时应把预算投在布点与台账上，而不是投在匹配算法上。

总原则是证据独立性：参与融合的信号，失效原因最好互不相关。Wi-Fi 指纹与蓝牙 RSSI 共享同一套射频环境，一次电源或拓扑改造可能同时打歪两者；气压与地磁的失效原因与射频无关，是更可靠的互补项。表格里那列运维负担，本质上是在问：主证据失效时，你有没有独立的第二证据可以顶上。

九、总结

全文收成一句话：Wi-Fi 指纹判楼层的难点不在匹配算法，而在把指纹当作动态环境信号来治理。工程上必须承认三件事——现场射频拓扑会变，而变更往往不是定位系统发起的；跨层相似是固有属性，垂直开敞空间与楼宇边缘的错误率天然更高；任何匹配算法都会给出结果，不主动输出不置信的系统就一定会沉默出错。

可落地的清单是七件事：AP 台账与变更通知、两级衰减监测、邻域增量重采与影子库切换、以 BSSID 与不可见维度为核心的特征选择、四态置信输出、按独立性排序的降级链、采集侧的最小必要与脱敏边界。这七件事做完，判层准确率才谈得上一条可运维的曲线；跳过任何一件，系统表现就取决于上一次网络改造距今多久。

最后重申能力边界：判层缩短的是“不知道人在哪层”的时延，它不改变事故是否发生。文中平台规则均取自手册原文，其余数值均为行业通用经验值，精度量级以现场实测与厂商资料为准。