.NET 9 Web API实现IMiddleware全局异常处理时依赖注入失败

针对你在.NET 9 ASP.NET Core Web API中使用IMiddleware实现全局异常处理时遇到的InvalidOperationException: Unable to resolve service for type异常，从以下几个核心方向排查：

1. 确认中间件类的访问权限 #

确保GlobalExceptionHandlingMiddleware是public类。IMiddleware的实例由DI容器创建，internal类会导致DI无法访问并实例化它，这是极易忽略的细节。

2. 检查构造函数的依赖项注册 #

查看GlobalExceptionHandlingMiddleware的构造函数，确认所有注入的服务都已在DI容器中完成注册：

• 若构造函数注入了ILogger<GlobalExceptionHandlingMiddleware>，除了调用builder.Services.AddLogging()，还要确保添加了具体的日志提供程序（比如builder.Services.AddLogging(logging => logging.AddConsole())），否则日志服务无法被正确解析。
• 若注入了自定义服务（如IExceptionHandler这类自己定义的接口），必须先通过AddTransient/AddScoped/AddSingleton将该服务注册到DI容器。

示例正确的构造函数实现：

public class GlobalExceptionHandlingMiddleware : IMiddleware
{
    private readonly ILogger<GlobalExceptionHandlingMiddleware> _logger;

    // 必须是public构造函数，且所有依赖项已完成注册
    public GlobalExceptionHandlingMiddleware(ILogger<GlobalExceptionHandlingMiddleware> logger)
    {
        _logger = logger;
    }

    public async Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        try
        {
            await next(context);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "未处理的异常发生");
            context.Response.StatusCode = StatusCodes.Status500InternalServerError;
            await context.Response.WriteAsJsonAsync(new { Error = "服务器发生未知错误" });
        }
    }
}

3. 规范中间件的注册与管道配置 #

使用IMiddleware时，注册和管道配置需匹配正确的方式：

• 服务注册（Startup.cs的ConfigureServices方法）：

// 方式1：通过接口注册
services.AddTransient<IMiddleware, GlobalExceptionHandlingMiddleware>();
// 方式2：直接注册具体类型（更简洁，推荐）
services.AddTransient<GlobalExceptionHandlingMiddleware>();

• 管道配置（Startup.cs的Configure方法）：

app.UseMiddleware<GlobalExceptionHandlingMiddleware>();

避免使用app.UseMiddleware(typeof(GlobalExceptionHandlingMiddleware))配合接口注册的方式，这种写法容易引发解析歧义，泛型版本的可靠性更高。

4. 适配.NET 9的DI验证规则 #

.NET 9对DI的验证更为严格，如果构造函数中包含可选参数，或者依赖项是“可选注册”的状态，会直接触发解析失败。确保所有构造函数参数都是必填项，且对应的服务已明确注册。

如果以上步骤排查后仍有问题，重点查看异常信息中明确指出的“无法解析的类型名称”——比如异常提示Unable to resolve service for type 'MyApp.Services.IExceptionHandler'，这时候只需要补充注册对应的服务即可解决问题。

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