基于Keycloak实现OpenID Connect时授权码模式报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模式操作流程参考:
- 发起授权请求:拼接完整授权端点地址
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值即为合法授权码- 60秒内完成令牌兑换:将上一步拿到的code填入请求体,确保请求中携带的
redirect_uri和第一步申请时使用的地址完全一致,同时使用admin-cli对应的客户端ID、密钥完成身份认证后发起请求- 禁止重复使用同一个code发起兑换请求
你当前提供的curl命令中使用的code值,没有通过完整的授权流程从Keycloak授权端点生成,本身就不满足有效性校验规则,是触发该报错的直接原因。
内容的提问来源于stack exchange,提问作者Saturnian
相关产品推荐
相关产品推荐

