ASP.NET Core 8.0 Web API中IExceptionHandler无法调试问题排查

1. 修正异常处理中间件配置 #

你当前使用的app.UseExceptionHandler("/Error")是传统错误路径的用法，会覆盖你注册的自定义IExceptionHandler。需要改为不带参数的UseExceptionHandler()，才能启用你注册的GlobalExceptionHandler：

修改Program.cs中的中间件配置：

// 替换掉 app.UseExceptionHandler("/Error");
app.UseExceptionHandler();

2. 处理模型验证错误（必填参数缺失场景） #

当接口必填参数未传入时，ASP.NET Core会触发模型验证失败，默认不会抛出异常，而是直接返回400响应，因此不会进入你的GlobalExceptionHandler。要让这类场景也走自定义处理器，可选择以下两种方式：

方式一：禁用默认模型验证响应，抛出异常让处理器捕获 #

步骤1：禁用默认的模型验证过滤器

在Program.cs中添加：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    // 禁用默认的模型验证失败响应
    options.SuppressModelStateInvalidFilter = true;
});

步骤2：添加自定义过滤器，模型验证失败时抛出异常

创建验证过滤器类：

public class ValidateModelStateFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        if (!context.ModelState.IsValid)
        {
            // 抛出验证异常，会被GlobalExceptionHandler捕获
            throw new ValidationException("请求参数验证失败", context.ModelState);
        }
    }

    public void OnActionExecuted(ActionExecutedContext context) { }
}

步骤3：注册过滤器

在Program.cs中添加：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<ValidateModelStateFilter>();
});

方式二：自定义ProblemDetails处理模型验证错误（无需抛出异常） #

如果你不想抛出异常，也可以在AddProblemDetails中直接定制模型验证失败的响应，确保和GlobalExceptionHandler输出格式一致：

builder.Services.AddProblemDetails(options =>
{
    options.CustomizeProblemDetails = context =>
    {
        // 处理模型验证失败的400错误
        if (context.ProblemDetails.Status == StatusCodes.Status400BadRequest)
        {
            var modelState = context.HttpContext.Features.Get<Microsoft.AspNetCore.Mvc.ModelBinding.IModelStateFeature>()?.ModelState;
            if (modelState != null && !modelState.IsValid)
            {
                context.ProblemDetails.Title = "请求参数验证失败";
                // 添加验证错误详情
                context.ProblemDetails.Extensions.Add("errors", modelState.Values.SelectMany(v => v.Errors.Select(e => e.ErrorMessage)));
            }
        }
    };
});

3. 调试验证 #

完成上述配置后重启项目：

• 接口抛出异常时，会进入GlobalExceptionHandler的TryHandleAsync方法，可正常调试
• 必填参数未传入时，会触发模型验证失败并进入自定义处理逻辑

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