ASP.NET Core JWT注销报错：服务描述符验证失败 无法解析IDistributedCache

第一阶段启动异常：无法解析IDistributedCache依赖 #

该错误触发原因是TokenManager类通过构造函数注入了IDistributedCache用于存储已注销JWT的黑名单，但ConfigureServices中未注册IDistributedCache的对应实现，依赖注入容器在解析服务实例时找不到依赖项，就会抛出服务描述符验证失败的AggregateException。

无论使用哪种分布式缓存实现，ASP.NET Core都要求显式注册IDistributedCache的实现，开发环境可直接使用内存实现快速验证，在ConfigureServices中添加以下代码即可解决该启动错误：

// 开发环境内存分布式缓存，无需依赖外部服务
services.AddDistributedMemoryCache();

第二阶段调用AddDistributedRedisCache后登录接口报错 #

该场景下的报错按优先级排查以下三类常见原因：

• Redis连通性与配置错误
  检查AddDistributedRedisCache传入的配置参数：确认连接字符串中的Redis地址、端口、密码填写正确，本地默认实例连接串通常为localhost:6379；提前通过redis-cli等工具确认Redis服务正常运行、对应端口未被防火墙拦截；注意旧版AddDistributedRedisCache依赖的StackExchange.Redis客户端版本与部署的Redis服务版本兼容性，版本跨度超过2个主版本大概率会出现握手失败、连接超时问题。
• JWT生成逻辑与缓存操作的代码错误
  检查登录接口生成JWT的代码逻辑：如果在生成令牌环节调用了缓存写入方法，确认所有异步操作都正确添加了await关键字，避免同步等待导致的线程死锁、任务取消异常；确认写入缓存的键（通常为JWT的唯一标识JTI）、缓存过期时间（需与JWT自身过期时间对齐）没有传入空值或非法格式值。
• 中间件管道顺序错误
  检查Configure方法中的中间件注册顺序：TokenManagerMiddleware必须注册在UseAuthentication、UseAuthorization之前，否则请求会先被授权中间件拦截，触发令牌校验失败；不要在中间件构造函数中编写同步等待Redis连接的逻辑，会导致管道初始化阻塞抛出异常。

验证流程建议 #

1. 先将缓存实现替换为AddDistributedMemoryCache，跑通登录生成JWT、调用注销接口将令牌加入黑名单、携带已注销令牌访问接口被拦截的全流程，确认JWT注销核心逻辑无代码bug
2. 核心逻辑验证通过后再切换Redis缓存实现，先单独编写测试接口验证缓存读写正常，再将Redis接入正式的令牌黑名单逻辑
3. 调试时在TokenManager的缓存读写、注销判断逻辑处添加断点，确认传入的JTI、过期时间等参数符合预期。

内容的提问来源于stack exchange，提问作者Abhi Singh