迁移至.NET 6类库，System.Web.Http的ExceptionHandler替代方案是什么？

.NET 6（ASP.NET Core）原生提供了完善的异常处理机制，完全可以替代System.Web.Http的ExceptionHandler，无需额外依赖第三方NuGet包，以下是具体方案：

1. 全局异常处理中间件（首选） #

使用ASP.NET Core内置的UseExceptionHandler扩展方法，全局捕获未处理异常并自定义响应，这是最贴近原ExceptionHandler功能的方案：

var builder = WebApplication.CreateBuilder(args);
// 注册你的服务（如Controllers、数据库上下文等）

var app = builder.Build();

// 配置全局异常处理
app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "application/json";

        var exceptionFeature = context.Features.Get<IExceptionHandlerPathFeature>();
        if (exceptionFeature != null)
        {
            // 自定义错误响应格式
            var errorResponse = new
            {
                Message = "服务器发生未预期错误",
                ErrorDetails = exceptionFeature.Error.Message,
                RequestPath = exceptionFeature.Path
            };

            await context.Response.WriteAsJsonAsync(errorResponse);
        }
    });
});

// 其他中间件配置（如静态文件、路由、授权等）
app.MapControllers();

app.Run();

2. 自定义异常过滤器（细粒度控制） #

如果需要针对特定控制器或动作方法做异常处理，可以自定义ExceptionFilterAttribute：

public class CustomExceptionFilter : ExceptionFilterAttribute
{
    public override void OnException(ExceptionContext context)
    {
        // 捕获异常并构造自定义响应
        context.Result = new ObjectResult(new
        {
            Status = "Error",
            Message = "请求处理失败",
            ExceptionMessage = context.Exception.Message
        })
        {
            StatusCode = StatusCodes.Status500InternalServerError
        };
        // 标记异常已处理，避免后续中间件重复处理
        context.ExceptionHandled = true;
    }
}

注册过滤器到全局：

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

也可以直接将过滤器标注在单个控制器或动作方法上：

[CustomExceptionFilter]
public class HomeController : ControllerBase
{
    // ...
}

补充说明 #

.NET 6的原生异常处理机制已经覆盖了System.Web.Http ExceptionHandler的所有核心场景，包括全局捕获、自定义响应、细粒度控制等，不需要额外寻找第三方包。如果需要更复杂的异常分类处理（比如区分业务异常、系统异常），可以在上述方案基础上扩展，比如自定义异常类型，在处理逻辑中判断异常类型返回不同响应。

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