.NET 6集成测试WebApplicationFactory挂起5分钟超时排查

你对WebApplicationFactory的运行机制存在理解偏差。
WebApplicationFactory构建测试宿主时，默认会扫描入口程序集的Program.Main方法作为宿主构建入口，但它的预期是入口逻辑仅完成IHost的构建、配置，返回可用的IHost实例，不会主动执行Run/RunAsync这类阻塞等待宿主关闭的启动方法。
你的代码中Main方法直接包含了await host.RunAsync(CancellationToken.None)逻辑，测试框架执行宿主构建流程时，运行到这行就会真的启动宿主并阻塞等待宿主停止，永远不会把构建完成的IHost返回给测试框架，最终等待5分钟触发框架内置的宿主构建超时异常：

System.InvalidOperationException : 等待入口点构建IHost超时，耗时00:05:00，可通过'DOTNET_HOST_FACTORY_RESOLVER_DEFAULT_TIMEOUT_IN_SECONDS'环境变量修改该超时时长。

• 方案一（推荐，符合官方集成测试约定）
  在Program类中暴露公共的CreateHostBuilder方法，把Host构建逻辑从Main的执行流程中拆分出来。WebApplicationFactory识别到这个方法后，会直接调用它构建IHostBuilder，不会执行完整Main方法里的RunAsync逻辑：

  public class Program
  {
      public static async Task Main(string[] args)
      {
          var host = CreateHostBuilder(args).Build();
  
          await host.InitialiseAsync(CancellationToken.None);
          await host.SeedAsync(CancellationToken.None);
  
          await host.RunAsync();
      }
  
      // 新增该公共方法，供测试框架识别Host构建逻辑
      public static IHostBuilder CreateHostBuilder(string[] args)
      {
          // 这里替换为你原来BuildWebHost方法的内部逻辑
          return BuildWebHost(args);
      }
  }
  

  注意该方法签名必须是public static IHostBuilder CreateHostBuilder(string[] args)，否则框架无法识别。

• 方案二（无需修改生产代码）
  自定义继承WebApplicationFactory<Program>的测试工厂，重写CreateHost方法，手动控制Host构建流程，跳过默认的Main方法解析逻辑，不要调用RunAsync：

  public class TestApplicationFactory : WebApplicationFactory<Program>
  {
      protected override IHost CreateHost(IHostBuilder builder)
      {
          var host = builder.Build();
          // 手动执行你需要的初始化、种子数据逻辑
          host.InitialiseAsync(CancellationToken.None).GetAwaiter().GetResult();
          host.SeedAsync(CancellationToken.None).GetAwaiter().GetResult();
          // 直接返回构建完成的Host，测试框架会自行启动测试服务
          return host;
      }
  }
  

  测试代码中替换为实例化这个自定义工厂即可：

  [Fact]
  public async Task Test1Async()
  {
      using var application = new TestApplicationFactory()
          .WithWebHostBuilder(builder =>
          {
              builder.ConfigureServices(services =>
              {
                  // 注册测试用服务
              });
          });
      var client = application.CreateClient();
      // 后续测试逻辑
  }
  

  额外注意：异步测试方法应该返回Task而非void，避免测试框架异步执行逻辑异常。

• 断点调试确认测试执行时是否还会命中Program.cs里的RunAsync代码行，如果命中说明CreateHostBuilder方法签名不符合要求，框架没有识别到，仍在执行完整Main逻辑。
• 检查InitialiseAsync、SeedAsync方法中是否存在死锁代码，比如是否存在用.Wait()、.Result同步阻塞异步方法的写法，是否在测试环境下触发线程死锁导致Host构建卡住。
• 检查初始化、种子数据逻辑是否依赖外部资源（比如数据库、Redis、消息队列），测试环境下是否因为网络不通、权限不足导致外部资源连接超时卡住。

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