IAsyncActionFilter实现中IMemoryCache的服务注入报错解决
自定义ApiKey授权特性的内存缓存正确实现
报错根因
调用
services.AddMemoryCache()时,DI容器注册的是IMemoryCache抽象接口,而非MemoryCache具体实现类。直接尝试解析具体实现类型,自然会触发“未注册服务”的异常。
原代码还存在两处逻辑漏洞:
- 调用
GetRequiredService后未将解析到的实例赋值给类内字段,后续读取缓存时会触发空引用- 只实现了缓存读取逻辑,从数据库查询到密钥后没有回写缓存,缓存永远无法命中,完全达不到提速效果
修复步骤
- 修正服务解析类型:将原来请求具体实现类的代码,改为请求已注册的
IMemoryCache接口,不要将服务实例存为特性类的成员字段(特性为单例对象,存储服务实例会引发生命周期劫持问题),直接在方法内解析使用即可 - 补全缓存回写逻辑:从数据库查询到对应客户端的有效ApiKey后,设置合理的过期时间(比如5分钟滑动过期)写入缓存,后续相同客户端的请求直接从缓存取数,无需查库
- 补全边界校验:对请求头中缺失
Client字段、ApiKey字段的场景提前返回401,避免空值导致的逻辑异常 - 清理冗余代码:删除未使用的
accessKey字段、重复读取请求头的冗余逻辑
修复后完整特性代码
[AttributeUsage(validOn: AttributeTargets.Class | AttributeTargets.Method)] public class ApiKeyAuthAttribute : Attribute, IAsyncActionFilter { private string _cachedApiKey; public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next) { // 直接从请求域解析已注册的IMemoryCache服务 var cache = context.HttpContext.RequestServices.GetRequiredService<IMemoryCache>(); var connection = context.HttpContext.RequestServices.GetRequiredService<ApiKeyContext>(); // 校验ApiKey请求头是否存在 if (!context.HttpContext.Request.Headers.TryGetValue("ApiKey", out var clientApiKey) || string.IsNullOrWhiteSpace(clientApiKey)) { context.Result = new UnauthorizedResult(); return; } // 校验Client请求头是否存在 if (!context.HttpContext.Request.Headers.TryGetValue("Client", out var apiClient) || string.IsNullOrWhiteSpace(apiClient)) { context.Result = new UnauthorizedResult(); return; } // 尝试从缓存读取对应客户端的有效密钥 if (!cache.TryGetValue<string>(apiClient.ToString(), out _cachedApiKey)) { // 缓存未命中则从数据库查询 _cachedApiKey = connection.ApiKey .Where(x => x.Client == apiClient.ToString()) .Select(x => x.Apikey1) .SingleOrDefault(); // 仅当查询到有效密钥时写入缓存,配置5分钟滑动过期 if (!string.IsNullOrEmpty(_cachedApiKey)) { cache.Set(apiClient.ToString(), _cachedApiKey, new MemoryCacheEntryOptions { SlidingExpiration = TimeSpan.FromMinutes(5) }); } } // 匹配密钥校验权限 if (string.IsNullOrEmpty(_cachedApiKey) || !_cachedApiKey.Equals(clientApiKey)) { context.Result = new UnauthorizedResult(); return; } await next(); } }
补充说明
- 现有启动类配置完全不需要修改,
AddMemoryCache()已经完成了正确的服务注册 - 如果需要强制刷新缓存,可以在更新数据库ApiKey的业务逻辑中,主动移除内存中对应Client的缓存键即可
- 缓存过期时间可根据业务实际调整,兼顾安全性与查询性能
内容的提问来源于stack exchange,提问作者john
相关产品推荐
相关产品推荐

