如何使用 xUnit 为 .NET 微服务编写测试?

来源:这里教程网 时间:2026-02-21 17:28:31 作者:

为 .NET 微服务编写测试时,xUnit 是一个轻量且高效的测试框架,广泛用于单元测试、集成测试和 API 测试。它与 .NET 生态系统无缝集成,适合微服务这种模块化架构。

安装 xUnit 并配置测试项目

在解决方案中创建一个独立的测试项目:

使用命令 dotnet new xunit -n MyMicroservice.Tests 创建测试项目 将测试项目引用主微服务项目:dotnet add reference ../MyMicroservice/MyMicroservice.csproj 确保已安装必要的包,如 Microsoft.NET.Test.Sdkxunit.runner.visualstudio

编写单元测试验证业务逻辑

针对服务中的核心类或方法编写隔离测试,例如一个订单处理服务:

public class OrderServiceTests
{
    [Fact]
    public void CalculateTotal_ShouldReturnCorrectAmount()
    {
        var service = new OrderService();
        var items = new List<OrderItem>
        {
            new OrderItem { Price = 10, Quantity = 2 },
            new OrderItem { Price = 5, Quantity = 4 }
        };
        var total = service.CalculateTotal(items);
        Assert.Equal(40, total);
    }
}

[Fact] 表示这是一个同步测试用例,适用于确定性逻辑验证。

进行集成测试模拟 HTTP API 调用

使用 TestServerWebApplicationFactory 启动内存中的服务实例,测试真实请求响应流程:

public class ProductApiTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly HttpClient _client;
    public ProductApiTests(WebApplicationFactory<Program> factory)
    {
        _client = factory.CreateClient();
    }
    [Fact]
    public async Task GetProducts_ReturnsSuccessStatusCode()
    {
        var response = await _client.GetAsync("/api/products");
        response.EnsureSuccessStatusCode();
        Assert.Equal("application/json", response.Content.Headers.ContentType?.MediaType);
    }
}

这种方式能验证路由、中间件、依赖注入和控制器行为是否正常。

使用断言和数据驱动测试提高覆盖率

xUnit 支持 [Theory][InlineData] 实现参数化测试:

[Theory]
[InlineData(-5)]
[InlineData(0)]
[InlineData(10)]
public void ValidateQuantity_ReturnsFalseForInvalidInput(int quantity)
{
    var result = OrderValidator.IsValidQuantity(quantity);
    Assert.False(result);
}

这有助于覆盖多个边界条件,提升测试效率。

基本上就这些。通过组合单元测试与集成测试,你可以全面保障 .NET 微服务的可靠性。测试应贴近实际运行环境,同时保持快速和可重复。

相关推荐