排错指南
验证码一直错误?先检查这四件事
从设备时间到认证参数,按顺序排查 TOTP 验证码无法通过的问题。
TOTP 验证码无法通过时,先检查设备时间、账户对应关系、算法配置,以及验证码是否已临近过期。不要将密钥发给他人“帮忙验证”。
1. 让设备时间自动同步
TOTP 的计算依赖时间。设备时钟偏差较大时,验证器与服务端会使用不同的时间步数。打开系统的自动日期与时间设置,确认设备能正常同步。
单纯改变时区通常不会修复问题,因为算法使用的是 Unix 时间,而不是屏幕显示的本地时区。
2. 确认你选中了正确账户
同一服务的多个账户、测试环境与正式环境,可能有相似标签。检查当前登录账户与认证器条目是否对应。
如果最近重新绑定过验证器,旧条目可能已经失效。服务端当前认可的密钥才是有效密钥。
3. 检查算法、位数和周期
常见配置为 SHA-1、6 位、30 秒,但不能据此认定所有服务都采用这些参数。检查服务方提供的配置,或使用 OTP 配置解析器读取链接中的参数。
不要通过反复猜测参数来替代平台的正式绑定流程。
4. 等下一组验证码再输入
临近周期结束时,验证码可能在你点击提交前已发生变化。等待新一组验证码出现后尽快输入,避免重复提交已使用的验证码。
服务端是否接受前后时间窗口、是否拒绝重复使用,由具体平台决定。
仍然失败怎么办?
先查阅平台的官方恢复流程,使用事先保存的恢复代码或其他已绑定的认证方式。不要在尚未确认恢复方式可用时,删除唯一的认证器条目。