常见问题与排障

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),请友好提示并允许重试;
  • 联调完成后联系通行证管理员在审计日志确认联调记录。