IdentityServer4 配置Reference Token无法获取Refresh Token的问题
核心说明
Reference Token和Refresh Token完全可以共存,不存在互斥限制,你遇到的refreshToken为null的问题和你配置的AccessTokenType = 1没有任何关系。
问题原因
IdentityServer4中,AllowOfflineAccess = true只是给客户端开通了申请Refresh Token的资格,不会自动在每次令牌请求里返回Refresh Token。按照OAuth2.0规范,必须在发起令牌请求时显式将offline_access这个标准Scope加入请求列表,服务端才会签发Refresh Token。
你当前的请求代码里,Scope参数只传了自定义的业务Scope,没有包含offline_access,相当于根本没有向服务端申请Refresh Token,自然拿到的是空值。
修复方法
- 先核对客户端的基础配置是否满足前提:
- 已正确开启密码模式授权:
AllowedGrantTypes = GrantTypes.ResourceOwnerPassword - 客户端的
AllowedScopes白名单中,同时包含你的业务Scope、内置的offline_access项
- 已正确开启密码模式授权:
- 修改请求代码的Scope参数,在原有业务Scope后拼接
offline_access,两个Scope之间用空格分隔,参考修改后的代码:
var tokenResponse = await client.RequestPasswordTokenAsync(new PasswordTokenRequest { Address = disco.TokenEndpoint, ClientId = ConfigurationExt.IdentityServer.ClientId, ClientSecret = ConfigurationExt.IdentityServer.ClientSecret, UserName = userName, Password = passwordHash, Parameters = parameters, // 显式带上offline_access以申请Refresh Token Scope = $"{ConfigurationExt.IdentityServer.Scope} offline_access" });
常见排查项(修改后仍无Refresh Token时核对)
- 检查
Parameters字典中有没有手动设置过Scope键:Duplicate的参数会覆盖之前单独赋值的Scope属性,导致服务端收不到offline_access - IdentityServer4对未授权的Scope采用静默过滤策略,不会抛出明确错误。如果申请的Scope不在客户端白名单中,会被直接剔除,一旦过滤后的Scope列表里没有
offline_access,就会返回null的Refresh Token,可通过服务端日志确认实际接收到的Scope值 - 再次确认
AccessTokenType的作用边界:这个配置仅控制访问令牌是自包含JWT(值为0)还是需校验的不透明Reference Token(值为1),和Refresh Token的生成流程完全独立,不存在配置冲突。
从设计逻辑上看,二者的定位完全不同:Reference Token是用于调用API的短期访问凭证,Refresh Token是用于无交互刷新访问令牌的长效凭证,从架构设计上就没有互斥的限制。
内容的提问来源于stack exchange,提问作者Zviad Kharazishvili
相关产品推荐
相关产品推荐

