IdentityServer4中自定义IPersistedGrantStore实现的刷新令牌问题

嘿，我碰到过类似的IdentityServer4自定义存储的问题，来帮你分析下：

你说自定义了基于XML文件的PersistedGrantStore，但添加services.AddTransient<IPersistedGrantService, PersistedGrantService>()和services.AddTransient<IPersistedGrantStore, PersistedGrantStore>()这两行后刷新令牌就出问题，移除就正常——这大概率是服务生命周期不匹配或者自定义实现里的小bug导致的。

首先排查服务生命周期问题 #

IdentityServer4默认对这两个服务的生命周期是有要求的：

• IPersistedGrantStore需要在多个请求间共享状态，默认是Singleton生命周期。如果你注册成Transient，每次请求都会新建一个存储实例，那之前保存的刷新令牌在新实例里根本读不到，自然刷新失败。
• IPersistedGrantService默认依赖IPersistedGrantStore，如果它也是Transient，每次请求都新建，搭配Transient的Store，数据完全没法共享。

你先试试把注册改成Singleton：

services.AddSingleton<IPersistedGrantStore, PersistedGrantStore>();
services.AddSingleton<IPersistedGrantService, PersistedGrantService>();

这一步解决过我之前遇到的类似问题。

然后检查自定义存储的逻辑 #

如果改了生命周期还是不行，就得排查你的XML存储实现了：

• 读写是否同步：比如保存刷新令牌时有没有正确写入XML文件？读取的时候是不是从正确的路径加载？可以在StoreAsync和GetAsync方法里加日志，看看刷新请求时有没有读取到对应的令牌记录。
• 并发问题：如果是Transient实例，并发请求可能同时读写XML文件，导致锁文件或者数据被覆盖，改成Singleton后这个问题也会缓解，但还是要确保你的XML操作是线程安全的。
• 序列化/反序列化错误：有没有可能把PersistedGrant对象序列化成XML时丢了字段？比如Expiration、Key这些关键属性没正确序列化，导致读取出来的对象无效。

举个例子，你可以在GetAsync里加日志：

public async Task<PersistedGrant> GetAsync(string key)
{
    _logger.LogInformation("Trying to get grant with key: {Key}", key);
    var xmlContent = await File.ReadAllTextAsync(_filePath);
    // 这里替换成你实际的XML反序列化逻辑
    var grants = YourXmlDeserializer.Deserialize<List<PersistedGrant>>(xmlContent); 
    var grant = grants.FirstOrDefault(g => g.Key == key);
    if (grant == null)
    {
        _logger.LogWarning("Grant {Key} not found in XML store", key);
    }
    return grant;
}

通过日志就能清楚看到刷新时有没有找到对应的令牌。

最后确认端点和客户端配置 #

日志里提到Endpoint enabled: Tok...，你可以把完整日志拉出来看看Token端点是不是正常启用。另外还要检查客户端配置：

• 客户端的AllowedGrantTypes必须包含GrantType.RefreshToken
• AllowOfflineAccess要设为true
• 刷新请求里的refresh_token参数是不是正确传递了

总结下排查步骤 #

1. 先把服务注册改成Singleton，测试刷新功能
2. 加日志排查自定义存储的读写逻辑，确认数据能正确存储和读取
3. 验证客户端配置和Token端点的正确性

内容的提问来源于stack exchange，提问作者Tom Janssens