C#集成测试入门指南（手把手教你测试Web API接口）

什么是集成测试？

与单元测试不同，集成测试关注的是多个组件之间的交互。例如，在 Web API 中，你可能需要测试：

• HTTP 请求是否被正确路由到控制器
• 数据库操作是否成功执行
• 返回的 JSON 数据格式是否正确

在 .NET 生态中，我们通常使用 xUnit 框架配合 Microsoft.AspNetCore.Mvc.Testing 来进行 Web API测试。

准备工作

首先，确保你已安装：

• .NET 6 或更高版本 SDK
• Visual Studio / VS Code / Rider 等 IDE

接下来，创建一个简单的 Web API 项目：

dotnet new webapi -n MyWebApicd MyWebApi

然后，添加一个用于测试的控制器（例如 WeatherForecastController.cs 已存在，我们直接使用它）。

创建集成测试项目

在项目根目录下，创建一个 xUnit 测试项目：

dotnet new xunit -n MyWebApi.Testsdotnet add MyWebApi.Tests reference MyWebApidotnet add MyWebApi.Tests package Microsoft.AspNetCore.Mvc.Testing

编写第一个集成测试

打开 MyWebApi.Tests/UnitTest1.cs，重命名为 WeatherForecastIntegrationTests.cs，并替换为以下代码：

using System.Net;using System.Threading.Tasks;using Microsoft.AspNetCore.Mvc.Testing;using Xunit;namespace MyWebApi.Tests{    public class WeatherForecastIntegrationTests    {        [Fact]        public async Task GetWeatherForecast_ReturnsSuccess()        {            // Arrange            var application = new WebApplicationFactory<Program>();            var client = application.CreateClient();            // Act            var response = await client.GetAsync("/weatherforecast");            // Assert            Assert.Equal(HttpStatusCode.OK, response.StatusCode);        }    }}

这段代码做了三件事：

1. Arrange：使用 WebApplicationFactory 启动你的 Web API 应用，并创建一个 HTTP 客户端。
2. Act：向 /weatherforecast 发送 GET 请求。
3. Assert：验证响应状态码是否为 200 OK。

运行测试

在终端中运行以下命令：

cd MyWebApi.Testsdotnet test

如果一切正常，你会看到测试通过的提示。这说明你的 ASP.NET Core集成测试环境已成功搭建！

进阶：测试返回内容

你还可以验证返回的 JSON 内容是否符合预期：

[Fact]public async Task GetWeatherForecast_ReturnsNonEmptyList(){    var application = new WebApplicationFactory<Program>();    var client = application.CreateClient();    var response = await client.GetAsync("/weatherforecast");    response.EnsureSuccessStatusCode(); // Throws if not 2xx    var content = await response.Content.ReadAsStringAsync();    Assert.Contains("summary", content);}

总结

通过本教程，你已经掌握了如何使用 C# 和 xUnit 对 Web API 进行集成测试。无论你是初学者还是有经验的开发者，掌握 xUnit测试教程中的这些基础技能，都能显著提升你的代码质量和开发效率。记住，良好的测试覆盖率是构建可靠系统的第一道防线！

现在，快去为你的项目添加集成测试吧！