.NET 6 Web API中如何用xUnit测试InternalServerError？

数据老陈

2026-7-27

如何断言ASP.NET Core单元测试中的500内部服务器错误

针对你的测试场景，需根据控制器的异常处理逻辑编写对应断言，以下是两种常见场景的实现：

场景1：使用`[ApiController]`自动异常处理

如果控制器标记了[ApiController]特性，未处理的异常会被框架自动包装为包含ProblemDetails的ObjectResult，状态码固定为500。此时完整测试代码如下：

[Fact]
public async Task ShouldReturnInternalServerError_OnUnhandledError()
{
    // arrange
    var Id = fixture.Create<string>();
    List<Emp> emps = fixture.Create<List<Emp>>();
    var exception = new Exception("Internal Server Error");

    factsService.Setup(x => x.SetEmps(Id, emps)).Throws(exception);

    // act
    var response = await EmpController.SetEmps(Id, emps);

    // assert
    response.Should().NotBeNull();
    
    // 断言返回类型为ObjectResult且状态码为500
    var objectResult = response.Should().BeAssignableTo<ObjectResult>().Subject;
    objectResult.StatusCode.Should().Be(StatusCodes.Status500InternalServerError);

    // 可选：断言ProblemDetails中的错误详情（匹配异常消息）
    var problemDetails = objectResult.Value.Should().BeAssignableTo<ProblemDetails>().Subject;
    problemDetails.Detail.Should().Contain(exception.Message);
}

场景2：控制器手动捕获异常返回500

如果控制器手动捕获异常并返回500状态码（例如使用StatusCode(500, errorMessage)），则断言逻辑可简化为：

// 替换原assert部分
response.Should().NotBeNull();
var objectResult = response.Should().BeAssignableTo<ObjectResult>().Subject;
objectResult.StatusCode.Should().Be(StatusCodes.Status500InternalServerError);
// 断言返回的错误消息与预期一致
objectResult.Value.Should().Be("Internal Server Error");