.NET 8中抛出异常时IExceptionHandler未触发的问题求助

你的IExceptionHandler未生效的核心原因是请求管道中缺少UseExceptionHandler中间件的注册，同时还有几处细节需要调整：

1. 必须添加UseExceptionHandler中间件 #

在.NET 8中，仅通过AddExceptionHandler注册处理类还不够，必须在请求管道中添加对应的中间件，且要放在端点路由（如MapGet、MapControllers）之前，否则异常无法被捕获。

修改后的Program.cs配置：

builder.Services.AddExceptionHandler<ExceptionHandler>();
builder.Services.AddProblemDetails();

var app = builder.Build();

// 关键：添加该中间件，且位置要在端点路由之前
app.UseExceptionHandler();

// 其他中间件（按需保留）
app.UseHttpsRedirection();

app.MapGet("/weatherforecast", () =>
{
    throw new ArgumentNullException("测试参数");
});

app.Run();

2. 优化异常处理类的实现细节 #

可以调整两处细节，让异常返回更规范、可读性更强：

• 先设置响应的HTTP状态码，确保和ProblemDetails中的Status字段一致
• 针对ArgumentNullException捕获参数名，返回更精准的错误信息

修改后的ExceptionHandler：

public class ExceptionHandler : IExceptionHandler
{
    public async ValueTask<bool> TryHandleAsync(HttpContext httpContext, Exception exception, CancellationToken cancellationToken)
    {
        ProblemDetails problemDetails;

        switch (exception)
        {
            case ArgumentNullException argNullEx:
                httpContext.Response.StatusCode = StatusCodes.Status400BadRequest;
                problemDetails = new ProblemDetails
                {
                    Status = StatusCodes.Status400BadRequest,
                    Type = exception.GetType().Name,
                    Title = "参数错误",
                    Detail = argNullEx.ParamName != null ? $"参数「{argNullEx.ParamName}」不能为空" : argNullEx.Message,
                    Instance = $"{httpContext.Request.Method} {httpContext.Request.Path}"
                };
                break;

            default:
                httpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;
                problemDetails = new ProblemDetails
                {
                    Status = StatusCodes.Status500InternalServerError,
                    Type = exception.GetType().Name,
                    Title = "服务器内部错误",
                    Detail = "服务器处理请求时发生未知异常",
                    Instance = $"{httpContext.Request.Method} {httpContext.Request.Path}"
                };
                break;
        }

        await httpContext.Response.WriteAsJsonAsync(problemDetails, cancellationToken);
        return true;
    }
}

3. 验证生效的注意点 #

• 如果开发环境启用了DeveloperExceptionPage，需要确保UseExceptionHandler在它之前注册，或者暂时关闭DeveloperExceptionPage来测试自定义异常处理逻辑（生产环境默认不会启用该页面）
• 确保所有可能抛出异常的中间件都在UseExceptionHandler之后注册

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