You need to enable JavaScript to run this app. 基于Keycloak实现OpenID Connect时授权码模式报Code not valid错误
优惠活动
大模型
产品
解决方案
定价
更多

基于Keycloak实现OpenID Connect时授权码模式报Code not valid错误

Keycloak authorization_code 模式返回 "Code not valid" 问题排查

该报错本质是Keycloak对提交的授权码执行有效性校验未通过,和client_credentials模式可正常获取令牌的表现不冲突——后者本身不涉及授权码申请、兑换环节,不受该链路的校验规则约束。常见触发原因与对应解决方式如下:

  • 授权码本身失效或不合法
    授权码是一次性、短时效临时凭据:从授权端点生成后默认有效期仅60秒,完成一次令牌兑换后会立即永久失效。如果出现code已被重复使用、生成code后超出有效期才提交、手动复制code时漏字符/多带空格的情况,会直接触发校验失败返回该报错。
  • redirect_uri 参数不匹配
    OIDC协议明确要求:兑换令牌时提交的redirect_uri,必须和申请授权码时传给授权端点的redirect_uri完全一字不差,不存在模糊匹配的容错空间。哪怕两者只差一个端口、末尾斜杠、http/https协议差异,Keycloak都会直接判定该code无效。例如申请code时使用的回调地址是http://localhost:9999/callback,但兑换令牌时传http://localhost:9999,哪怕你在合法重定向URI列表中配置了后者,依然会校验失败。
  • 客户端身份绑定不匹配
    授权码和申请它的客户端是强绑定关系:如果生成code时使用的客户端ID,和兑换令牌时通过Basic认证头携带的客户端ID不一致,哪怕两个客户端属于同一个test-realm域,也会直接判定code无效。
  • 流程上下文缺失导致校验失败
    手动拼接授权链接测试时,如果漏传scope=openid参数、缺失生成授权码时携带的state/nonce参数,生成的code本身不满足OIDC标准校验规则,后续兑换时会直接触发"Code not valid"报错。

正确的authorization_code模式操作流程参考:

  1. 发起授权请求:拼接完整授权端点地址http://localhost:8080/auth/realms/test-realm/protocol/openid-connect/auth?client_id=admin-cli&response_type=code&redirect_uri=http://localhost:9999&scope=openid&state=任意随机字符串,浏览器打开完成身份登录后,页面会自动跳转到配置的回调地址,地址栏URL参数中携带的code值即为合法授权码
  2. 60秒内完成令牌兑换:将上一步拿到的code填入请求体,确保请求中携带的redirect_uri和第一步申请时使用的地址完全一致,同时使用admin-cli对应的客户端ID、密钥完成身份认证后发起请求
  3. 禁止重复使用同一个code发起兑换请求
    你当前提供的curl命令中使用的code值,没有通过完整的授权流程从Keycloak授权端点生成,本身就不满足有效性校验规则,是触发该报错的直接原因。

内容的提问来源于stack exchange,提问作者Saturnian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 09:15:08