.NET 9集成测试中异常处理过滤器无法捕获异常的排查

问题 #

在.NET 9环境下用WebApplicationFactory编写集成测试，启动主程序Program.cs调用接口时，接口抛出未处理异常仅返回通用500错误，无法记录异常堆栈信息。

试过的无效操作 #

• 使用IStartupFilter添加异常处理中间件：调试时await _next.Invoke执行后从未进入catch块
• 改用IExceptionFilter实现：过滤器完全未被触发

问题根源 #

平台初始化代码已配置两个异常处理器（基于IActionFilter和IExceptionFilter），执行顺序导致自定义过滤器无法捕获异常：

1. 框架异常过滤器
2. 自定义异常过滤器
3. 框架动作过滤器
4. 接口端点
5. 框架动作过滤器（捕获异常）

解决办法 #

调整自定义过滤器的执行顺序 #

给自定义过滤器设置更高的Order值，让它在框架动作过滤器之后执行，确保能捕获到异常：

public class CustomExceptionFilter : IExceptionFilter
{
    private readonly ILogger<CustomExceptionFilter> _logger;

    public CustomExceptionFilter(ILogger<CustomExceptionFilter> logger)
    {
        _logger = logger;
    }

    // 设置为int.MaxValue，确保在框架过滤器之后执行
    public int Order => int.MaxValue;

    public void OnException(ExceptionContext context)
    {
        // 记录完整异常堆栈信息
        _logger.LogError(context.Exception, "接口抛出未处理异常");
        
        // 可选：返回包含堆栈的自定义响应
        context.Result = new ObjectResult(new 
        { 
            ErrorMessage = context.Exception.Message, 
            StackTrace = context.Exception.StackTrace 
        })
        {
            StatusCode = StatusCodes.Status500InternalServerError
        };
        context.ExceptionHandled = true;
    }
}

在测试项目中注册自定义过滤器 #

在WebApplicationFactory的配置里，替换原有异常过滤器并注册自定义的：

public class TestWebAppFactory<TProgram> : WebApplicationFactory<TProgram> where TProgram : class
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureServices(services =>
        {
            // 移除已注册的异常过滤器（可选，根据需求决定是否保留原有逻辑）
            var existingFilters = services.Where(d => d.ServiceType == typeof(IExceptionFilter)).ToList();
            foreach (var filter in existingFilters)
            {
                services.Remove(filter);
            }

            // 添加自定义异常过滤器
            services.AddScoped<IExceptionFilter, CustomExceptionFilter>();
        });
    }
}

备选方案：用中间件直接捕获异常 #

如果过滤器方式仍有问题，直接注册异常处理中间件，将其放在所有中间件最前面：

protected override void ConfigureWebHost(IWebHostBuilder builder)
{
    builder.Configure(app =>
    {
        // 优先添加异常处理中间件
        app.Use(async (context, next) =>
        {
            try
            {
                await next();
            }
            catch (Exception ex)
            {
                var logger = context.RequestServices.GetRequiredService<ILogger<TestWebAppFactory<TProgram>>>();
                logger.LogError(ex, "未处理异常详情");
                
                // 输出包含堆栈的响应
                context.Response.StatusCode = StatusCodes.Status500InternalServerError;
                context.Response.ContentType = "application/json";
                await context.Response.WriteAsJsonAsync(new 
                { 
                    Error = ex.Message, 
                    StackTrace = ex.StackTrace 
                });
            }
        });

        // 保留原应用的中间件配置
        app.UseRouting();
        app.UseAuthorization();
        app.MapControllers();
    });
}

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