FastEndpoints全局错误处理失效：抛异常仍返回200状态码

核心问题根源 #

你遇到的问题大概率是中间件注册顺序错误，导致UseDefaultExceptionHandler()无法捕获端点执行时抛出的异常。此外，也可能存在其他异常处理中间件冲突或框架版本问题。

具体解决方案 #

1. 调整中间件注册顺序

FastEndpoints的UseDefaultExceptionHandler()必须在路由、端点映射及其他业务中间件之前注册。如果它被放在MapEndpoints()之后，请求会优先被端点处理，异常无法被后续的异常处理中间件捕获，最终导致响应状态码异常。

正确的注册顺序示例：

var builder = WebApplication.CreateBuilder(args);

// 注册FastEndpoints及其他服务
builder.Services.AddFastEndpoints();
// ...其他服务注册

var app = builder.Build();

// 第一步：注册全局异常处理中间件
app.UseDefaultExceptionHandler();

// 第二步：注册认证、授权等中间件
app.UseAuthentication();
app.UseAuthorization();

// 最后：映射端点
app.MapEndpoints();

app.Run();

2. 验证异常捕获逻辑

如果调整顺序后问题仍存在，可以自定义异常处理逻辑，确认是否捕获到目标异常：

app.UseDefaultExceptionHandler(opt =>
{
    opt.UnhandledException = async (ctx, ex) =>
    {
        // 添加日志输出，排查是否捕获到InvalidDataException
        Console.WriteLine($"捕获到异常：{ex.GetType().Name} - {ex.Message}");
        
        ctx.Response.StatusCode = StatusCodes.Status500InternalServerError;
        await ctx.Response.WriteAsJsonAsync(new 
        { 
            ErrorCode = "InternalServerError",
            Message = "服务器处理请求时发生错误" 
        });
    };
});

3. 排查中间件冲突

如果项目中同时使用了ASP.NET Core原生的UseExceptionHandler()或其他第三方异常处理中间件，可能会与FastEndpoints的UseDefaultExceptionHandler()冲突，建议移除或调整优先级。

4. 升级FastEndpoints版本

部分旧版本的FastEndpoints存在异常处理逻辑的bug，建议升级到最新稳定版，确保框架能正确处理端点内抛出的未捕获异常。

补充说明 #

你的端点代码中，jwtTokenService.GetToken(user)是在构造SendAsync的参数时同步抛出异常，此时响应头尚未发送，正常情况下全局异常处理应该能捕获该异常并返回500状态码。调整中间件顺序后即可解决返回200的问题。

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