ASP.NET集成测试遇未处理异常求助（GlobalExceptionHandler已配置）

问题原因 #

集成测试框架默认会检测并重新抛出中间件/过滤器中捕获的异常——哪怕你的全局异常处理器已经生成了正确的HTTP响应。这是因为测试框架会检查IExceptionHandlerFeature是否存在，只要该特征存在，就会判定为未处理异常并抛出。

解决方案 #

1. 在全局异常处理器中清除异常特征 #

在GlobalExceptionHandler中间件处理完异常后，手动清除HttpContext中的异常特征，让测试框架认为异常已被完全处理：

public class GlobalExceptionHandler : IMiddleware
{
    private readonly ILogger<GlobalExceptionHandler> _logger;

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

    public async Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        try
        {
            await next(context);
        }
        catch (SpecificException ex)
        {
            _logger.LogError(ex, "特定异常触发");
            
            // 构造并返回自定义响应
            context.Response.StatusCode = StatusCodes.Status400BadRequest;
            context.Response.ContentType = "application/json";
            var errorResponse = new { Message = ex.Message, Code = "SPECIFIC_ERROR" };
            await context.Response.WriteAsJsonAsync(errorResponse);

            // 关键操作：清除异常特征，避免测试框架捕获
            context.Features.Set<IExceptionHandlerFeature>(null);
        }
    }
}

2. 配置WebApplicationFactory禁用异常重抛 #

如果不想修改生产代码，可在测试项目的自定义WebApplicationFactory中添加配置，禁用测试框架的异常重抛行为：

public class TestWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram> where TProgram : class
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureServices(services =>
        {
            // 按需替换或添加测试专属服务
        });

        // 禁用测试框架的异常重抛逻辑
        builder.UseSetting("ASPNETCORE_TESTING__DISABLE_EXCEPTION_RETHROW", "true");
    }
}

3. 验证响应而非依赖异常捕获 #

在集成测试用例中，不要通过捕获异常来断言结果，直接验证HTTP响应的状态码和响应体内容即可：

[Fact]
public async Task When_SpecificExceptionThrown_ReturnsBadRequestWithError()
{
    // 初始化测试客户端
    var client = _factory.CreateClient();

    // 调用触发异常的接口
    var response = await client.GetAsync("/api/test/throw-specific-exception");

    // 断言响应状态码和内容
    Assert.Equal(HttpStatusCode.BadRequest, response.StatusCode);
    var responseBody = await response.Content.ReadFromJsonAsync<ErrorResponse>();
    Assert.Equal("SPECIFIC_ERROR", responseBody.Code);
    Assert.Equal("预期的异常提示文本", responseBody.Message);
}

这种方式不依赖测试框架的异常检测逻辑，只要响应符合预期，测试就能通过。

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