You need to enable JavaScript to run this app. IAsyncActionFilter实现中IMemoryCache的服务注入报错解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 15:06:03