webapplicationfactory是首选，因其完整重放生产环境主机构建流程，自动加载配置、注册服务、支持所有端点；高频失败原因包括共享框架版本不一致、未调用configurewebhostdefaults及appcontext开关未同步。
直接用 WebApplicationFactory<program></program>，别手写 TestServer 构建逻辑——它会自动复用生产环境的 DI、中间件、配置加载流程，否则极易漏掉 IHostEnvironment 或路由注册等关键环节。
为什么 WebApplicationFactory 是首选
它不是“包装 TestServer 的语法糖”，而是把整个 ASP.NET Core 主机构建流程（WebApplication.CreateBuilder() → builder.Build()）在测试进程内完整重放。这意味着：
- 所有
Program.cs里的AddDbContext、AddControllers、ConfigureServices都生效，不用手动补注册 - 环境变量（如
ASPNETCORE_ENVIRONMENT=test）和appsettings.test.json自动加载 - 不会出现
No service for type 'IHostEnvironment'这类错误——因为宿主本身就是按生产路径构建的 - Hot Chocolate GraphQL 端点、REST API、健康检查端点全部可测，无需额外桥接
WebApplicationFactory 启动失败的三个高频原因
报错 System.InvalidOperationException: No service for type 'Microsoft.Extensions.Hosting.IHostEnvironment' 本质是测试宿主没走通真实构建链路。常见触发点：
- 测试项目引用的
Microsoft.AspNetCore.App共享框架版本 ≠ 主项目版本（例如主项目用 .NET 8.0，测试项目用了 7.0） - 重写了
ConfigureWebHost却没调用builder.ConfigureWebHostDefaults(...)，导致默认服务未注册 - 主项目用了
AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false)，但测试中没同步设置，导致TestServer发出的内部请求绕过内存管道、直连本地 127.0.0.1
并发测试必须复用 HttpClient 实例
TestServer 本身不是线程安全的，也不排队或并行化请求。并发发压时若每个测试都调用 _factory.CreateClient()，大概率触发 ObjectDisposedException 或请求挂起。
- 正确做法：在
IClassFixture<webapplicationfactory>></webapplicationfactory>中创建一次HttpClient，所有测试方法共用它 - 需要带不同 header（如 bearer token）？用
new HttpClient(_handler) { DefaultRequestHeaders = { ... } }复用底层HttpMessageHandler - 并发发起请求必须用
await Task.WhenAll(tasks)，别用Parallel.For或混合同步阻塞（如.Wait()） - 注意：瓶颈不在网络层，而在你自己的中间件或 EF Core 查询——
TestServer完全绕过 Kestrel 和 Socket
GraphQL 端点测试和 REST 没区别
只要你的 Program.cs 正确注册了 Hot Chocolate（比如 builder.AddGraphQLServer().AddQueryType<query>()</query>），WebApplicationFactory 启动后，/graphql 就能正常响应 POST 请求。
- 构造请求体用标准 JSON：
{"query":"{ hello }"}，Content-Type 设为application/json - 别试图 mock
ISchema或替换IGraphQLRequestExecutor——那已退化为单元测试，不是集成验证 - 如果返回 404，先确认路由是否注册（
MapGraphQL是否被调用）、是否启用了 CORS（测试 client 默认无 origin） - 对
GraphQL响应做断言时，优先检查response.StatusCode和 JSON 结构（如data.hello字段是否存在），而非原始 HTML
真正容易被忽略的是：测试项目与主项目的共享框架版本一致性，以及 AppContext.SetSwitch 这类底层网络开关的同步。这两个点不校准，WebApplicationFactory 就算代码写对了，也会在 CI 上静默失败。
