.NET 6/7中WebApplicationFactory+Playwright集成测试报错求助

一、修复“Build can only be called once”错误 #

原方案中重复调用同一个IHostBuilder的Build()方法，而IHostBuilder实例仅允许构建一次，这是报错的直接原因。正确做法是不复用传入的builder，而是基于程序的HostBuilder模板创建全新实例构建Kestrel服务器，同时保留原builder构建TestHost以满足WebApplicationFactory的内部校验要求。

修改后的CreateHost方法示例：

protected override IHost CreateHost(IHostBuilder builder)
{
    // 构建TestHost，用于满足WebApplicationFactory的内部校验逻辑
    var testHost = builder.Build();

    // 创建全新的HostBuilder实例构建Kestrel服务器，规避原builder的Build次数限制
    var kestrelHostBuilder = Program.CreateHostBuilder(null)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseKestrel();
            // 同步原builder的核心配置，确保测试环境一致性
            webBuilder.ConfigureServices(services =>
            {
                // 可在此复制原builder的服务替换逻辑（如Mock服务、内存数据库等）
            });
        });

    // 启动Kestrel服务器
    _kestrelHost = kestrelHostBuilder.Build();
    _kestrelHost.Start();

    // 获取Kestrel监听地址并设置到ClientOptions
    var server = _kestrelHost.Services.GetRequiredService<IServer>();
    var addressesFeature = server.Features.Get<IServerAddressesFeature>();
    var kestrelAddress = addressesFeature.Addresses
        .Select(addr => new Uri(addr))
        .Last();
    ClientOptions.BaseAddress = kestrelAddress;

    // 启动TestHost并返回，满足WebApplicationFactory的要求
    testHost.Start();
    return testHost;
}

二、解决Blazor应用显示Fatal页面的问题 #

修改后出现Fatal页面，通常是因为TestHost与Kestrel服务器配置不一致，或Blazor静态资源加载失败，可从以下方向排查修复：

• 同步运行环境：确保Kestrel服务器使用与TestHost相同的环境（如Development），避免生产环境的错误屏蔽：

  var kestrelHostBuilder = Program.CreateHostBuilder(null)
      .UseEnvironment(Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Development")
      .ConfigureWebHostDefaults(webBuilder => { /* ... */ });
  

• 统一服务配置：原builder可能包含测试专用的服务替换（如Mock依赖），需确保KestrelHostBuilder同步应用这些配置，避免依赖不一致导致启动失败：

  // 提取共享配置方法
  public static void ConfigureTestServices(IServiceCollection services)
  {
      // 添加测试专用服务配置，如替换数据库为内存实现
  }
  
  // 在CreateHost中同时应用到两个HostBuilder
  builder.ConfigureServices(ConfigureTestServices);
  kestrelHostBuilder.ConfigureServices(ConfigureTestServices);
  

• 确保静态资源可访问：Blazor依赖静态资源（.js、.css等），需确认Kestrel服务器正确配置静态文件中间件：

  webBuilder.Configure(app =>
  {
      app.UseStaticFiles();
      app.UseRouting();
      app.MapBlazorHub();
      app.MapFallbackToPage("/_Host");
  });
  

• 查看详细错误日志：Blazor默认Fatal页面不显示详细错误，可在_Host.cshtml的开发环境配置中开启调试日志：

  <environment include="Development">
      <script src="_framework/blazor.webassembly.js" autostart="false"></script>
      <script>
          Blazor.start({
              onError: function (err) {
                  console.error(err);
                  alert(err.message);
              }
          });
      </script>
  </environment>
  

  同时查看浏览器控制台的具体错误信息，定位问题根源。

额外注意事项 #

• 避免TestHost与Kestrel服务器的端口冲突，确保两者使用独立配置（如Kestrel用动态端口，TestHost用默认TestServer端口）。
• 尽量保持测试项目与Blazor应用的.NET版本一致，减少跨版本兼容的潜在问题。

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