运行ASP.NET Core集成测试报IHost未构建异常解决方法

这个异常的核心触发逻辑是：WebApplicationFactory在启动集成测试服务时，会拉起被测Web应用的入口程序集执行，直到入口逻辑执行完毕都没有捕获到IHost实例的构建动作，就会抛出这个错误。结合你贴出的代码，最高概率的诱因是你在自定义工厂的构造函数中直接调用了CreateClient()方法。

CreateClient()方法内部会先调用EnsureServer()强制触发宿主构建、测试服务启动流程，但此时你的自定义工厂实例还没完成构造，基类WebApplicationFactory的宿主解析、入口点挂载逻辑都还没初始化完成，自然无法捕获到IHost构建动作，直接触发报错。
除此之外还有几个常见诱因：

• 被测项目的入口逻辑（Program.cs）存在提前退出分支：比如根据启动参数、环境变量判断，在执行到builder.Build()（IHost构建代码）之前就return/退出进程，测试场景下传入的启动参数、环境变量和本地直接运行不同，刚好命中提前退出分支。
• 测试项目未正确引用被测Web项目，或者输出目录缺失被测项目的入口程序集、运行时配置文件，导致宿主解析器找不到IHost构建逻辑。
• .NET 6+使用顶级语句编写Program.cs时，没有将Program类声明为可对外访问，测试程序集无法读取入口点的Host构建逻辑。

• 首先修正构造函数中初始化客户端的逻辑
  不要在构造函数里直接调用CreateClient()生成HttpClient，把客户端初始化逻辑延迟到工厂完全初始化完成后再执行，推荐用懒加载的方式实现：

  // 先删除构造函数里 ManagedHttpClient = CreteManagedClient(); 这行
  private HttpClient? _managedHttpClient;
  public HttpClient ManagedHttpClient
  {
      get
      {
          _managedHttpClient ??= CreateClient(new WebApplicationFactoryClientOptions
          {
              BaseAddress = new Uri(_configuration.GetValue<string>("IntegrationServerBaseUri"))
          });
          return _managedHttpClient;
      }
  }
  

  顺带提一句，你原来的客户端创建方法名拼写有误（CreteManagedClient应为CreateManagedClient），虽然不影响运行，但建议修正避免后续维护混淆。

• 检查被测项目Program.cs的执行逻辑
  从入口第一行开始逐段检查，确认所有执行分支最终都会走到var app = builder.Build();这行IHost构建代码，不要在Host构建前写Environment.Exit()、提前return之类的逻辑。如果有根据启动参数、运行环境判断的分支，注意适配集成测试场景：WebApplicationFactory默认启动的环境是Development，传入的启动参数为空数组，不要让这类分支跳过Host构建流程。

• 检查项目引用与输出配置
  确认测试项目对被测Web项目的引用正常，没有在引用节点配置ExcludeAssets="All"之类的规则；重新生成整个解决方案，检查测试项目的输出目录中，是否存在被测项目的dll、exe、runtimeconfig.json三个核心文件，缺失的话手动清理bin、obj目录后重新生成。

• 配置顶级语句Program的访问级别
  如果你用.NET 6+的顶级语句编写Program.cs，在被测项目Program.cs的末尾添加如下代码，开放Program类的访问权限：

  public partial class Program { }
  

• 断点调试定位
  如果上述步骤都没解决问题，在自定义工厂中重写CreateHost方法加断点，同时在被测项目Program.cs的入口起始位置加断点，调试运行测试，看代码执行到哪个位置提前退出，没有走到Host构建逻辑。

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