ASP.NET Core如何让同请求内所有子作用域共享Scoped服务实例

默认ASP.NET Core内置DI容器的Scoped生命周期只和当前解析实例所用的IServiceScope绑定，不存在内置的「请求级全局单例」规则：手动调用CreateScope()生成的子作用域有独立的Scoped实例缓存，因此和请求根作用域解析出的实例不是同一个，这是容器的默认设计，不是异常。

要实现同一HTTP请求下，无论创建多少个子作用域都拿到同一个服务实例，可以利用HttpContext的请求级缓存特性实现，步骤如下：

• 首先注册IHttpContextAccessor，ASP.NET Core默认不会自动注册这个服务：

public void ConfigureServices(IServiceCollection services)
{
    services.AddHttpContextAccessor();
    // 其他服务注册
}

• 用工厂模式注册目标服务，将实例缓存到当前请求的HttpContext.Items集合中——这个集合在整个请求生命周期内唯一，不管在请求流程中创建多少个子作用域，访问到的都是同一个集合：

services.AddScoped<IMyService>(sp =>
{
    var httpContextAccessor = sp.GetRequiredService<IHttpContextAccessor>();
    var httpContext = httpContextAccessor.HttpContext;
    
    // 非HTTP请求场景（比如后台任务、单元测试手动创建作用域）降级为普通Scoped逻辑
    if (httpContext == null)
    {
        return ActivatorUtilities.CreateInstance<MyService>(sp);
    }

    // 从请求缓存取实例，不存在则新建后存入缓存
    if (!httpContext.Items.TryGetValue(typeof(IMyService), out var serviceInstance))
    {
        // 从请求根作用域RequestServices解析依赖，保证依赖也为请求级唯一
        serviceInstance = ActivatorUtilities.CreateInstance<MyService>(httpContext.RequestServices);
        httpContext.Items[typeof(IMyService)] = serviceInstance;
    }

    return (IMyService)serviceInstance;
});

注意事项 #

• 该方式实现的实例生命周期完全和HTTP请求绑定，请求结束后HttpContext被回收，缓存的服务实例也会随之被释放，不会造成内存泄漏
• 不要将该类服务注入到Singleton生命周期的服务中，会产生captive dependency问题（长生命周期服务持有短生命周期服务实例，导致服务无法正常释放），和普通Scoped服务的使用约束一致
• 如果需要多个服务实现这种跨子域请求单例，可以封装一个通用的注册扩展方法，复用上述逻辑即可，不用每个服务单独编写重复代码

不需要为了这个需求引入第三方DI容器，上述原生实现足够轻量可靠，不会增加额外依赖。

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