ASP.NET Core 8 Web API中IExceptionHandler无法正常工作求助

问题原因 #

1. 中间件顺序错误：异常处理中间件必须在所有可能抛出异常的中间件（路由、控制器、认证授权等）之前注册，才能捕获后续异常。你的UseExceptionHandler放在了UseDeveloperExceptionPage及其他核心中间件之后，无法拦截异常。
2. 开发环境调试页面拦截：UseDeveloperExceptionPage在开发环境下会优先捕获异常并返回调试页面，直接覆盖了自定义IExceptionHandler的逻辑。
3. 冗余配置干扰：app.UseExceptionHandler(opt => {})的空配置块属于无效设置，无需保留。

修复方案 #

1. 调整中间件执行顺序 #

修改Startup.cs的Configure方法，将异常处理中间件放在最顶部，并根据环境控制调试页面的使用：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 异常处理中间件必须放在所有中间件最前面
    app.UseExceptionHandler();

    if (env.IsDevelopment())
    {
        // 如需测试自定义异常处理，注释掉此行；保留则开发环境使用默认调试页面
        // app.UseDeveloperExceptionPage();
        app.UseSwagger();
        app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "v1"));
    }

    app.UseHttpsRedirection();
    app.UseRouting();
    app.UseAuthentication();
    app.UseAuthorization();

    // 全局CORS策略
    app.UseCors(x => x
        .AllowAnyOrigin()
        .AllowAnyMethod()
        .AllowAnyHeader());

    app.UseEndpoints(x => x.MapControllers());
}

2. 完善自定义ExceptionHandler（可选） #

当前代码未手动设置响应状态码，需补充以确保响应符合HTTP规范：

public class ExceptionHandler : IExceptionHandler
{
    public async ValueTask<bool> TryHandleAsync(HttpContext context, Exception ex, CancellationToken ct)
    {
        ProblemDetails problemDetails;

        switch (ex)
        {
            case ArgumentNullException:
                context.Response.StatusCode = StatusCodes.Status400BadRequest;
                problemDetails = new ProblemDetails
                {
                    Status = StatusCodes.Status400BadRequest,
                    Type = ex.GetType().Name,
                    Title = ex.Message,
                    Detail = ex.Message,
                    Instance = $"{context.Request.Method} {context.Request.Path}"
                };
                break;

            default:
                context.Response.StatusCode = StatusCodes.Status500InternalServerError;
                problemDetails = new ProblemDetails
                {
                    Status = StatusCodes.Status500InternalServerError,
                    Type = ex.GetType().Name,
                    Title = "Internal server error",
                    Detail = "Internal server error",
                    Instance = $"{context.Request.Method} {context.Request.Path}"
                };
                break;
        }

        await context.Response.WriteAsJsonAsync(problemDetails, ct);
        return true;
    }
}

3. 验证效果 #

注释掉UseDeveloperExceptionPage后，调用authenticate接口，抛出的异常会被自定义处理器捕获，返回预期的ProblemDetails格式响应。

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