白名单与黑名单

一句话定义

白名单是允许通行或消费的人员清单，黑名单是禁止的清单；断网时设备靠白名单判断能不能刷。

两者的分工

白名单解决「谁可以」—— 这台设备上允许消费或通行的人员及其权限。它必须完整下载到设备本地，因为断网时设备只能靠它判断。

黑名单解决「谁不可以」—— 挂失卡、离职人员、异常卡。它可以是增量下发的，因为一般只关心最近新增的挂失。

一句话：白名单是「通行证」，黑名单是「通缉令」。

同时存在时谁优先

标准做法是黑名单优先：一张卡只要在黑名单里，即使在白名单里也禁止使用。

理由很直接 —— 黑名单里放的是挂失卡、离职卡、异常卡，这些是不该被放行的；如果白名单优先，挂失卡就能继续刷，黑名单就失去意义了。

实施时要注意：把卡加进黑名单的同时，最好也从白名单移除，避免两份名单长期不一致。

容量怎么规划

国万消费机的白名单容量是 20000 张，需要按「单台设备服务的人数」核对：

够用的情况：一台设备管一个年级（几百人）、一个车间（几十到几百人）、一个食堂窗口（数千人）。

要留意的情况：园区共用设备、大型学校集中就餐 —— 总人数可能接近或超过 2 万，需要按设备分区承载，或者选更大容量的机型。

黑名单容量通常比白名单小得多，因为挂失卡在补办后可以移出。但如果长期不清理，黑名单会越积越多，建议定期清理已补办的旧卡。

同步频率与断网的影响

白名单同步：人员变动不频繁，可以每天同步一次，或在批量办卡后手动触发。同步完要核对「设备回传的成功条数 = 名单总数」，不相等说明有遗漏。

黑名单同步：挂失是突发事件，频率要高，建议改成「实时下发 + 定时全量」，也就是挂失时立即推送，同时每隔一段时间全量覆盖一次，防止漏发。

断网的影响：断网期间白名单是旧版本 —— 新办卡的人刷不了（因为本地还没有他），刚挂失的卡还能刷（因为黑名单没收到）。这是 脱网记账 的固有局限，不是故障。所以断网恢复后，要尽快做一次全量同步。

一个常见运维问题

「新办卡的人刷不了，但别人都能刷」—— 八成是白名单没同步到这台设备。排查顺序：

① 看设备回传的白名单条数是否等于系统总人数；

② 看这个人是否在名单里、状态是否为「正常」；

③ 看设备是否在线（心跳机制）、最后一次同步时间。

如果三步都正常还刷不了，再查卡本身。