ASP.NET Core自定义IExceptionHandler无法优先捕获异常的问题

为什么调试模式下自定义处理器能生效？ #

ASP.NET Core在开发（调试）环境下，内置的DeveloperExceptionPageMiddleware会保留完整的异常传递链路，不会自动拦截ModelStateInvalidException这类模型绑定/序列化异常直接返回400，而是让异常继续流转到后续注册的自定义处理器。但在生产（常规）环境下，内置的ApiBehaviorOptions默认会自动捕获这类模型绑定错误，直接返回标准化400响应，跳过了自定义处理器。

让自定义处理器优先触发的解决步骤 #

1. 调整中间件注册顺序 #

自定义异常处理中间件必须早于所有内置错误处理中间件注册，因为ASP.NET Core中间件按注册顺序执行，先注册的先处理请求与异常。示例代码：

app.UseRouting();

// 先注册自定义异常处理器
app.UseCustomExceptionHandler();

// 再注册内置错误处理组件（如果需要）
app.UseExceptionHandler("/error");
app.UseStatusCodePages();

app.UseEndpoints(endpoints => { ... });

2. 禁用内置模型验证自动响应 #

在Program.cs（或Startup.cs）中配置ApiBehaviorOptions，关闭内置的模型绑定错误自动拦截逻辑，让异常能流转到自定义处理器：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    options.SuppressModelStateInvalidFilter = true;
});

3. 在自定义处理器中显式处理ModelStateInvalidException #

确保自定义处理器能捕获并处理输入错误导致的ModelStateInvalidException，示例核心逻辑：

public async Task InvokeAsync(HttpContext context)
{
    try
    {
        await _next(context);
    }
    catch (ModelStateInvalidException ex)
    {
        // 自定义响应逻辑：提取错误详情并返回自定义格式
        var errorDetails = ex.ModelState.Values
            .SelectMany(v => v.Errors)
            .Select(e => e.ErrorMessage);
        
        var response = new 
        { 
            Code = 400, 
            Message = "输入数据格式错误", 
            Details = errorDetails 
        };
        
        context.Response.StatusCode = StatusCodes.Status400BadRequest;
        context.Response.ContentType = "application/json";
        await context.Response.WriteAsJsonAsync(response);
    }
    catch (Exception ex)
    {
        // 处理其他异常的逻辑
        ...
    }
}

完成以上配置后，无论调试还是常规启动模式，自定义异常处理器都能优先捕获输入数据错误引发的序列化/模型绑定异常，返回你自定义的响应格式。

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