如何在NUnit测试的[SetUp]中启动ASP.NET Core Web API服务？

完全可以，不需要额外创建独立的Web项目，直接在NUnit测试的[SetUp]阶段用.NET 6的最小API就能快速搭建一个仅在测试期间运行的本地临时Web服务。以下是具体实现方案：

前置准备 #

确保你的测试项目已安装以下NuGet包：

• NUnit
• NUnit3TestAdapter
• Microsoft.NET.Test.Sdk
• （可选）Microsoft.AspNetCore.Mvc.Testing：简化HTTP客户端的创建和测试

完整测试代码示例 #

using NUnit.Framework;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using System.Net.Http;
using System.Linq;
using System.Threading.Tasks;

[TestFixture]
public class NuGetPackageIntegrationTests
{
    private WebApplication? _testWebApp;
    private HttpClient? _httpClient;

    [SetUp]
    public async Task InitializeTestWebApi()
    {
        // 构建最小API实例
        var builder = WebApplication.CreateBuilder();
        var app = builder.Build();

        // 定义单个GET测试接口
        app.MapGet("/api/test", () => Results.Ok(new 
        { 
            Status = "Success", 
            Data = "测试接口返回内容" 
        }));

        // 绑定到本地随机端口（系统自动分配，避免端口冲突）
        app.Urls.Add("http://localhost:0");
        _testWebApp = app;

        // 异步启动服务
        await _testWebApp.StartAsync();

        // 获取系统分配的实际端口，初始化HTTP客户端
        var actualServiceUrl = _testWebApp.Urls.First(u => u.StartsWith("http://localhost:"));
        _httpClient = new HttpClient { BaseAddress = new System.Uri(actualServiceUrl) };
    }

    [TearDown]
    public async Task CleanupTestWebApi()
    {
        // 停止服务并释放资源，保证测试环境隔离
        if (_testWebApp != null)
        {
            await _testWebApp.StopAsync();
            _testWebApp.Dispose();
        }
        _httpClient?.Dispose();
    }

    [Test]
    public async Task TestGetEndpointReturnsExpectedContent()
    {
        // 调用测试接口
        var response = await _httpClient!.GetAsync("/api/test");
        response.EnsureSuccessStatusCode();

        var responseContent = await response.Content.ReadAsStringAsync();
        Assert.That(responseContent, Does.Contain("测试接口返回内容"));
        Assert.That(responseContent, Does.Contain("Success"));
    }
}

关键细节说明 #

• 随机端口绑定：使用http://localhost:0让系统自动分配未被占用的端口，避免本地开发环境的端口冲突问题
• 异步生命周期管理：NUnit 3支持异步的[SetUp]和[TearDown]，用StartAsync()和StopAsync()优雅管理服务生命周期
• 最小API简化：无需定义控制器，直接通过MapGet快速注册接口，满足集成测试的基础服务需求
• 环境隔离：每个测试用例启动独立的服务实例，测试完成后立即销毁，避免测试间的状态污染

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