.NET NUnit集成测试WebApplicationFactory运行报错调试正常问题

这个异常的核心触发原因是WebApplicationFactory的主机初始化是异步执行的：调试模式下调试器附加会带来天然的执行延迟，主机在你访问Server属性前已经完成后台启动，所以不会报错；全速运行测试时，你在[SetUp]阶段访问application.Server的时机早于主机启动完成的时间点，就会抛出该异常。
另外你当前的写法还有两个隐性问题：

• 没有做资源释放，WebApplicationFactory和HttpClient都实现了IDisposable接口，测试执行完成后不释放会造成资源泄漏
• 直接访问Server属性创建客户端的方式，不会触发WebApplicationFactory内置的主机启动保障逻辑

方案1：最小改动修复 #

不要直接通过Server属性创建客户端，优先调用WebApplicationFactory自带的CreateClient()方法，这个方法内部会自动保证主机启动完成后再返回HttpClient实例，修改后的初始化代码如下：

public class Initializer
{
    protected WebApplicationFactory<Program> application { get; set; }
    protected HttpClient client { get; set; }
    protected IServiceProvider _serviceProvider;

    [SetUp]
    public void RunBeforeAnyTests()
    {
        application = new WebApplicationFactory<Program>().WithWebHostBuilder(conf =>
        {
            conf.UseEnvironment("Test");
        });
        // 替换原有的application.Server.CreateClient()调用
        client = application.CreateClient();
        // 触发主机启动保障逻辑，确保服务容器可用
        _ = application.Server; 
        _serviceProvider = application.Services;
    }

    [TearDown]
    public void RunAfterAnyTests()
    {
        client.Dispose();
        application.Dispose();
    }
}

方案2：异步初始化（适配.NET 6+ 版本，更稳妥） #

如果项目是.NET 6及以上版本，NUnit支持异步Setup逻辑，可以显式等待主机启动完成，从根源规避时序问题：

public class Initializer
{
    protected WebApplicationFactory<Program> application { get; set; }
    protected HttpClient client { get; set; }
    protected IServiceProvider _serviceProvider;

    [SetUp]
    public async Task RunBeforeAnyTests()
    {
        application = new WebApplicationFactory<Program>().WithWebHostBuilder(conf =>
        {
            conf.UseEnvironment("Test");
        });
        // 显式等待主机启动完成
        await application.StartAsync();
        client = application.CreateClient();
        _serviceProvider = application.Services;
    }

    [TearDown]
    public async Task RunAfterAnyTests()
    {
        await client.DisposeAsync();
        await application.DisposeAsync();
    }
}

如果改完上述逻辑依然报错，检查两个配置项：

• 确认入口项目的Program类对测试项目可见：.NET 6+顶级语句生成的Program类默认是internal级别，需要在入口项目中添加配置<InternalsVisibleTo Include="你的测试项目名称"/>，避免测试项目无法正确加载启动配置
• 确认测试项目使用的SDK是Microsoft.NET.Sdk.Web，而非普通的Microsoft.NET.Sdk，普通SDK不会自动引入Web主机启动依赖，会导致初始化逻辑异常

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