.NET 6仅开发环境报错：无法从根解析服务，因依赖作用域服务xxContext

错误现象 #

仅在**Development（开发）**环境中触发以下错误：

Cannot resolve 'service' from root provider because it requires scoped service 'xxContext'.

错误发生在调用UseOcelot方法时，根源是中间件栈中的某个组件尝试访问数据库上下文（DB Context）。

相关代码 #

Program.cs实现：

var builder = WebApplication.CreateBuilder(args);

builder.Configuration.AddJsonFile(
    Path.Combine("configuration", $"configuration.{builder.Environment.EnvironmentName}.json")
    );

MicroserviceInit.SetConfigurationFromAzureKeyVault(builder.Environment.EnvironmentName, builder.Configuration);

var startup = new Startup(builder.Configuration);

startup.ConfigureServices(builder.Services);

var app = builder.Build();

startup.Configure(app, app.Services.GetRequiredService<TelemetryConfiguration>());

await app.UseOcelot(config => config.PreErrorResponderMiddleware = startup.PreErrorResponderMiddleware);

app.Run();

堆栈跟踪 #

at Microsoft.Extensions.DependencyInjection.ServiceLookup.CallSiteValidator.ValidateResolution(Type serviceType, IServiceScope scope, IServiceScope rootScope)
   at Microsoft.Extensions.DependencyInjection.ServiceProvider.GetService(Type serviceType, ServiceProviderEngineScope serviceProviderEngineScope)
   at Microsoft.Extensions.DependencyInjection.ServiceProvider.GetService(Type serviceType)
   at Microsoft.Extensions.Internal.ActivatorUtilities.ConstructorMatcher.CreateInstance(IServiceProvider provider)
   at Microsoft.Extensions.Internal.ActivatorUtilities.CreateInstance(IServiceProvider provider, Type instanceType, Object[] parameters)
   at Microsoft.AspNetCore.Builder.UseMiddlewareExtensions.<>c__DisplayClass5_0.<UseMiddleware>b__0(RequestDelegate next)
   at Microsoft.AspNetCore.Builder.ApplicationBuilder.Build()
   at Microsoft.AspNetCore.Builder.WebApplication.Microsoft.AspNetCore.Builder.IApplicationBuilder.Build()
   at Ocelot.Middleware.OcelotPipelineExtensions.BuildOcelotPipeline(IApplicationBuilder app, OcelotPipelineConfiguration pipelineConfiguration)
   at Ocelot.Middleware.OcelotMiddlewareExtensions.CreateOcelotPipeline(IApplicationBuilder builder, OcelotPipelineConfiguration pipelineConfiguration)
   at Ocelot.Middleware.OcelotMiddlewareExtensions.<UseOcelot>d__2.MoveNext()
   at Ocelot.Middleware.OcelotMiddlewareExtensions.<UseOcelot>d__1.MoveNext()
   at Program.<<Main>$>d__0.MoveNext() in C:\...\.Gateway\Program.cs:line 26

核心原因 #

这个错误本质是根服务容器无法解析作用域（Scoped）生命周期的服务：

• ASP.NET Core中，根服务容器是全局实例，不绑定任何请求上下文；而xxContext这类数据库上下文默认是Scoped生命周期，只能在请求作用域内被解析。
• 开发环境默认启用ServiceProviderOptions.ValidateScopes验证，会严格检查作用域服务的解析时机；生产环境通常关闭该验证，因此只有开发环境会触发报错。

具体触发场景：

1. 中间件构造函数注入Scoped服务：如果PreErrorResponderMiddleware或Ocelot管道中的自定义中间件在构造函数中直接注入了xxContext，那么在应用启动构建中间件栈时（即UseOcelot执行阶段），根服务容器会尝试解析该Scoped服务，此时还没有请求作用域，直接触发错误。
2. 根容器直接获取依赖Scoped的服务：代码中app.Services.GetRequiredService<TelemetryConfiguration>()如果TelemetryConfiguration依赖了Scoped服务，也可能引发类似问题，但从堆栈跟踪看，更可能是中间件构造注入的问题。

修复方案 #

方案1：在请求阶段获取Scoped服务（推荐） #

修改中间件实现，不在构造函数中注入Scoped服务，而是在Invoke/InvokeAsync方法中通过HttpContext.RequestServices获取——此时已处于请求作用域内，能正常解析Scoped服务。

示例代码：

public class PreErrorResponderMiddleware
{
    private readonly RequestDelegate _next;

    // 构造函数仅注入Singleton/Transient生命周期的服务
    public PreErrorResponderMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 在请求处理阶段从请求作用域获取Scoped服务
        var dbContext = context.RequestServices.GetRequiredService<xxContext>();
        // 执行业务逻辑
        await _next(context);
    }
}

方案2：关闭开发环境的作用域验证（不推荐） #

如果必须在中间件构造时获取Scoped服务，可以临时关闭开发环境的作用域验证，但这会隐藏潜在的生命周期问题，仅建议用于临时排查：

var builder = WebApplication.CreateBuilder(args);

if (builder.Environment.IsDevelopment())
{
    builder.Host.UseDefaultServiceProvider(options =>
        options.ValidateScopes = false);
}

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