访客券为什么失效
访客券（临时账号）失效的表现通常是「昨天还能用，今天就不行」，原因集中在四类：有效期已过、使用次数用尽、绑定策略限制（首登绑定 MAC，换设备即失效）、凭证系统与 Portal 或控制器状态不同步。排查的关键是两边都查——只在凭证系统或只在控制器查询，很容易得出互相矛盾的结论。
基本信息
| 有效期 | 是否已过期或被管理员回收 |
|---|---|
| 次数限制 | 单券单次或多次，用过后是否应失效 |
| 绑定策略 | 首登绑定 MAC 或设备，换设备需重新发放 |
| 同步问题 | 凭证系统与控制器未同步导致状态不一致 |
| 排查顺序 | 先看有效期与绑定，再看系统同步 |
典型使用场景
- 访客到前台重新领券后仍然连不上
- 同一张券给第二台设备使用失败
- 批量发券后部分券无法激活
- 排查凭证系统与控制器的状态差异
- 评估改用短信或扫码认证的可行性
排查步骤
排查步骤
# 在凭证系统与控制器分别查询该券状态
# 比对四项：状态、有效期、绑定设备、使用次数
# 若两边一致但仍不可用，检查 Portal 的认证日志
# 确认终端时间是否正确，时间偏差会影响状态判断失效原因对照
| 原因 | 特征 | 处理 |
|---|---|---|
| 已过期 | 时间点明确 | 重新发放或延期 |
| 次数用尽 | 已有成功认证记录 | 按策略重新发放 |
| 绑定冲突 | 换设备后失败 | 解绑或重新发券 |
| 两端不同步 | 单边查询结论矛盾 | 触发同步并复核 |
「昨天还能用今天不能用」先看有效期与绑定策略，再看系统同步；这两组原因的表现非常相似，顺序错了会绕远路。
单券单次与单券多设备是两种常见策略：发券前先确认策略口径，否则会把正常行为当成故障。
不要忽略两端系统的时间同步：时间偏差会直接影响有效期判定与认证结果，是隐蔽但常见的失效来源。