帮助中心 › 账号与登录 › SSO 登录问题

SSO 登录提示“令牌已过期”/ 无法登录怎么排查

帮助编号 HELP-SSO-002 · 更新 2026-09-12 · 适用 SSO 统一登录 v3.2+ · 维护:平台组 xu.mo

归藏内部系统统一走 SSO 登录(sso.guizang.internal),登录成功后签发 8 小时有效期的会话令牌。以下按“最常见 → 较少见”排序列出自助排查步骤;多数问题在前 3 步即可解决。

1. 先确认是不是全局故障

打开 服务状态页,看“SSO 统一登录”是否为正常。状态页显示“维护中/降级”时不用排查本机,等待恢复即可;维护窗口固定在每月第二个周二 23:00–23:30。

2. 三个高频原因与处理

2.1 设备时间偏移(最常见)

SSO 对客户端时间敏感,偏差超过 120 秒会直接判定令牌“已过期”或“尚未生效”。办公电脑休眠唤醒后时间未同步非常常见。

处理:同步系统时间后重新登录。
内网 NTP 地址见 /etc/chrony.conf 或 IT 下发的入网说明;Windows 可在“设置 → 时间和语言 → 立即同步”。
验证:chronyc tracking 输出 System time 绝对值应小于 0.5 秒。

2.2 多设备登录与令牌上限

同一账号最多保留 5 个有效会话。超过后最早的会话会被踢出,表现为旧设备上“令牌已过期”。如果你在多台设备/浏览器上登录过,先在 SSO 控制台“我的会话”里注销不用的设备。

2.3 服务端账号状态

账号被锁定(连续输错 5 次)、权限组变更或离所交接都会导致登录失败。错误提示通常不直接说明原因,需要看错误码(见第 4 节)。

3. 彻底清一次状态

  1. 退出所有已登录系统(至少 SSO、文档站、GitLab、Harbor);
  2. 清除浏览器对 *.guizang.internal 的 Cookie 与站点数据;
  3. 重启浏览器,重新访问 sso.guizang.internal;
  4. 仍然失败则换一个浏览器验证是否与浏览器扩展有关(广告拦截类扩展会拦截跳转)。

4. 错误码对照

提示码含义处理
SSO-1001令牌缺失或已注销重新登录;确认没有多设备互踢
SSO-1004设备时间偏移超限 同步时间后重试
SSO-1012账号被锁定等待 15 分钟或找部门管理员解锁
SSO-1020无该应用权限在权限平台申请对应系统权限
SSO-1031会话数超上限(5)注销旧设备会话
SSO-1035第三方登录源不可用切换为账号密码登录,报工单
SSO-1099未归类错误记录时间与请求 ID,报工单标签 help
注意:SSO 不支持把密码或令牌通过聊天工具发给他人协助排查。任何索要密码、验证码的消息都按安全事件处理。

5. 特殊场景

6. 还是不行?

在工单系统提交,标签 help,附上:发生时间、浏览器版本、错误码、已尝试步骤。工作时段响应 4 小时内;紧急情况联系值班(见值班手册)。

相关:值班手册 §5 账号与权限 · 接口配额申请 · 返回帮助中心