如何为 .NET 微服务编写集成测试？

来源：这里教程网时间：2026-02-21 17:29:00 作者：

为 .NET 微服务编写集成测试的关键是模拟真实运行环境，验证服务与其他组件（如数据库、消息队列、其他微服务）的交互是否正确。集成测试不只关注单个类或方法，而是测试整个请求流程，从 HTTP 入口到数据持久化或外部调用。

使用 TestServer 进行端到端测试

.NET 提供 Microsoft.AspNetCore.Mvc.Testing 包，允许你在内存中启动一个测试用的

TestServer

，无需真正部署服务。这样可以测试控制器、中间件、依赖注入和配置加载等完整流程。

安装 NuGet 包：

示例测试代码：

public class WeatherControllerTests : IClassFixture>
{
  private readonly WebApplicationFactory _factory;

  public WeatherControllerTests(WebApplicationFactory factory)
  {
    _factory = factory;
  }

  [Fact]
  public async Task Get_ReturnsSuccess()
  {
    var client = _factory.CreateClient();
    var response = await client.GetAsync("/weather");

    response.EnsureSuccessStatusCode();
    Assert.Contains("application/json", response.Content.Headers.ContentType.ToString());
  }
}

隔离外部依赖：数据库与服务调用

集成测试应尽量真实，但也要避免依赖不稳定或昂贵的资源。常见做法包括：

使用内存数据库：对 Entity Framework Core 测试时，用
DbContext
配合
InMemoryDatabase
或
SQL Server LocalDB
快速初始化测试数据。 替换 HttpClient：通过
IHttpClientFactory
和
MockHttpMessageHandler
模拟第三方 API 响应，避免网络请求。 清理状态：每个测试后重置数据库或使用事务回滚，保证测试独立性。

测试跨服务通信

微服务常依赖其他服务（如用户服务、订单服务）。你可以：

启动被依赖的服务在测试环境中（Docker Compose），进行真实调用。 使用 Pact 或 WireMock 创建契约或模拟服务，确保接口兼容。 在测试中注入模拟的
HttpClient
，返回预定义 JSON 响应。

例如，使用

MockHttpMessageHandler

模拟用户服务：

var mockHttp = new MockHttpMessageHandler();
mockHttp.When("https://userservice/api/users/1")
.Respond("application/json", "{ \"id\": 1, \"name\": \"John\" }");

var client = mockHttp.ToHttpClient();
client.BaseAddress = new Uri("https://userservice/");