常见问题与排障
OIDC 登录与服务端开放能力的常见报错对照表:现象、原因、处理方式。
更新于 2026-10-10
常见问题与排障
本文是接入通行证过程中常见报错的对照表:现象、原因、处理方式。
一、OIDC 登录
| 现象 | 原因 | 处理 |
|---|---|---|
回调报 invalid client_id |
client_id 错误或应用被停用 | 核对 client_id;联系管理员确认应用状态 |
换 token 报 invalid_grant |
code 已使用 / 已过期(一次性,10 分钟有效)或 redirect_uri 不一致 | 重新发起授权;检查是否有重复提交 |
| 授权页报 redirect 错误 | 回调地址与登记不一致 | 一字不差地重新登记(含 https、路径、结尾斜杠) |
userinfo 401 invalid_token |
access_token 过期(2 小时) | 用 refresh_token 续期(需 offline_access) |
| 授权跳转到「协议确认页」 | 平台协议更新或用户撤回了同意 | 正常流程,用户同意后自动继续(见《协议同意门禁》) |
consent_required(prompt=none) |
用户有待同意协议 | 引导用户走一次交互式登录 |
| state 校验失败 | 请求不是你的平台发起或已过期 | 直接拒绝,重新发起 |
二、服务端开放能力
| 现象 | 原因 | 处理 |
|---|---|---|
| 6106 签名不符 | 签名串拼接错 / body 哈希错 / query 被重新编码 | 按《签名规范》逐段核对 |
| 6321 | 用户余额不足 | 正常业务错误 |
| 403 | 应用等级不足 | 联系通行证管理员提升应用等级 |
三、通用建议
client_secret/app_secret不要写进前端代码或仓库文件;- 用户在授权页点「拒绝」时回调带
error(而非code),请友好提示并允许重试; - 联调完成后联系通行证管理员在审计日志确认联调记录。