WebApplicationFactory 是轻量宿主而非魔法代理，需正确配置项目引用、隐式 using、认证模拟及生命周期管理，否则易出现编译失败、401错误、性能下降等问题。
别在每个测试里 new WebApplicationFactory，也别指望它自动带登录或复用生产配置——它只是个轻量宿主，不是魔法代理。
WebApplicationFactory 编译失败或找不到类型
常见现象是 CS0246: 未能找到类型或命名空间名称“Program”，或者运行时报 System.IO.FileNotFoundException。根本原因不是代码写错了，而是项目引用或隐式 using 没对齐。
- 测试项目必须通过
dotnet add reference ../YourApp/YourApp.csproj添加**项目引用**，不能只装 NuGet 包 - .NET 6+ 默认入口是
Program类，.NET 5 及以前是Startup；混用会直接编译不过，比如测试项目 TargetFramework 是net6.0，但被测项目是net5.0+Startup - 若被测项目启用了
<ImplicitUsings>enable</ImplicitUsings>，测试项目也得开，否则编译器认不出WebApplicationFactory<T>
HttpClient.GetFromJsonAsync 报“未找到该扩展方法”
这不是 WebApplicationFactory 的问题，而是缺包 + 缺 using。它底层调用 SendAsync 并反序列化，但**不检查 HTTP 状态码**——401/403 会直接抛 HttpRequestException，而不是返回 null。
- 必须安装 NuGet 包：
System.Net.Http.Json - 必须加命名空间：
using System.Net.Http.Json; - 别裸调
client.GetFromJsonAsync<User>("/api/users")，先加EnsureSuccessStatusCode()或包try/catch - 如果 API 启用了
AddProblemDetails()（比如全局异常中间件），响应体是ProblemDetails结构，不是你的User类型，此时建议改用client.GetAsync()+ 手动读response.Content.ReadAsStringAsync()
测试 [Authorize] 控制器时始终 401
WebApplicationFactory 默认不带任何认证上下文，它不会自动登录、也不会读取 appsettings.Development.json 里的 JWT 配置。你得手动塞 header，或替换掉认证服务。
- 最简方式：在
CreateClient()后设置client.DefaultRequestHeaders.Authorization = new("Bearer", "fake-jwt-token") - 更可控的方式：重写
ConfigureWebHost，用builder.ConfigureTestServices(services => { ... })替换IAuthenticationService或注入TestAuthHandler - 别在测试里依赖生产环境的
AddJwtBearer配置——它需要真实密钥、签发者等，测试中无法满足，硬上只会卡在 token validation 阶段 - 内存数据库等依赖，必须在
ConfigureWebHost的ConfigureTestServices中注册，否则仍走生产注册逻辑
为什么测试变慢、CI 偶发失败
核心问题往往藏在生命周期管理里：new 太多、没清理、状态残留。这不是性能瓶颈，是设计误用。
- 每个测试方法都
new WebApplicationFactory<Program>()？它会重建整个 DI 容器和中间件管道，开销大且可能污染状态 - 正确做法：用 xUnit 的
IClassFixture<MyWebApplicationFactory>，让一个测试类共用一个 factory 实例 - 别在
Dispose()里调GC.Collect()——fixture 生命周期已由 xUnit 保证，手动 GC 反而干扰运行时 - 如果启动失败报
No service for type 'Microsoft.Extensions.Hosting.IHostEnvironment'，大概率是测试项目没引用和主项目一致的Microsoft.AspNetCore.App共享框架版本，或ConfigureWebHostDefaults被绕过了
最容易被忽略的一点：WebApplicationFactory 不处理前端交互，也不模拟浏览器行为。它只管后端 HTTP 层。想测 JS 渲染、表单提交、跳转链路？那已经超出它的职责范围了。
