WebApplicationFactory 是启动真实内存内 ASP.NET Core 应用实例的集成测试工具，需正确配置入口类型、复用实例、处理认证、数据库隔离及第三方服务 Mock。

WebApplicationFactory 是集成测试的起点

它不是模拟容器，而是真正启动一个轻量级、内存内的 ASP.NET Core 应用实例，所有中间件、依赖注入、配置、路由都按真实逻辑运行——但不监听真实端口，也不依赖 IIS 或 Kestrel。这意味着你测的是“跑起来的程序”，不是一堆 Mock 对象拼凑的假象。

最简用法：var factory = new WebApplicationFactory()（.NET 6+ 推荐指向 Program 类；若用传统 Startup 模式，则指向 Startup）。注意：必须确保 TEntryPoint 所在程序集能被当前测试项目引用，否则编译失败或运行时报 System.IO.FileNotFoundException。

• 不要在测试类构造函数里反复 new WebApplicationFactory，它会创建独立应用上下文，开销大；应作为 [ClassFixture] 复用
• 若测试中修改了配置（如数据库连接字符串），需通过 WithWebHostBuilder() 覆盖，直接改 IConfiguration 实例无效
• .NET 7+ 中若项目启用了 ImplicitUsings，测试项目也需保持一致，否则可能找不到 WebApplicationFactory 类型

HttpClient.GetFromJsonAsync 等扩展方法需要显式添加 System.Net.Http.Json

很多人写完 factory.CreateClient() 后直接调 client.GetFromJsonAsync("/api/users")，结果编译报错：“GetFromJsonAsync 未找到”。这不是 WebApplicationFactory 的问题，而是缺少 NuGet 包和 using。

• 必须安装 System.Net.Http.Json NuGet 包（.NET 5+ 内置但需显式引用）
• 必须加 using System.Net.Http.Json;
• 该扩展方法底层调用 SendAsync 并自动反序列化，但不会自动处理 401/403 等非成功状态码——遇到时抛 HttpRequestException，需 try/catch 或用 EnsureSuccessStatusCode()
• 若 API 返回 ProblemDetails（如启用 AddProblemDetails()），默认 JSON 反序列化会失败，建议用 GetAsync() + 手动读取 response.Content.ReadAsStringAsync() 再判断状态码

测试带认证的控制器要手动设置 Authorization Header 或注入 TestAuthHandler

WebApplicationFactory 默认不带任何认证上下文。即使你在 Startup 里配了 JWT Bearer 或 Cookie 认证，CreateClient() 发出的请求仍是匿名的。

• 最简单方式：给 HttpClient 加 header：client.DefaultRequestHeaders.Authorization = new("Bearer", "valid.jwt.token")；token 可用 Microsoft.IdentityModel.Tokens.JwtSecurityTokenHandler 在测试中快速生成
• 更可控方式：重写 ConfigureWebHost，用 services.AddAuthentication().AddScheme("TestScheme", _ => { })，并在测试中用 client.DefaultRequestHeaders.Authorization = new("TestScheme", "dummy")
• 切勿在测试中复用生产环境的密钥或签发服务——容易因时间偏移、密钥轮换导致 token 验证失败；用测试专用的 SymmetricSecurityKey 就够了

数据库污染和事务回滚必须自己管理

WebApplicationFactory 不会自动帮你清库或开事务。如果你的 API 写了数据库，每次测试跑完数据就留在那里，下次测试可能因主键冲突、唯一约束或脏数据失败。

• 推荐方案：用 Sqlite InMemory 数据库（UseSqlite("DataSource=:memory:")），并在每个测试前调 context.Database.OpenConnection(); context.Database.EnsureCreated();
• 若必须用 SQL Server / PostgreSQL，可在 WithWebHostBuilder 中替换 IDbContextFactory，让每次测试获取全新上下文，并在 Dispose 时执行 context.Database.EnsureDeleted()
• 别依赖 T

  

  ransactionScope 自动回滚——它在某些 EF Core 版本和数据库驱动下不生效，尤其跨线程或异步调用时
• 如果 API 内部用了 SaveChangesAsync 以外的持久化方式（如直接调用 Dapper 或原始 ADO.NET），事务隔离必须手动包裹，WebApplicationFactory 完全不管这些

最难缠的其实是第三方服务耦合：邮件发送、消息队列、外部 HTTP 调用。它们不会因为你用了 WebApplicationFactory 就自动变成可测的。得在 ConfigureWebHost 里把对应服务替换成 Mock 或内存实现，而且要确保替换时机早于控制器被解析——否则依赖注入容器已经缓存了真实实例，Mock 就白注册了。

# js  # json  # cookie  # app  # 端口  # 工具  # iis  # ai  # 路由  # microsoft  # nas  # 状态码  # c#  # .net  # sql  # 中间件  # 构造函数 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 如何在万网利用已有域名快速建站？  如何快速生成高效建站系统源代码？  手机网站制作与建设方案,手机网站如何建设？  Laravel如何安装Breeze扩展包_Laravel用户注册登录功能快速实现【流程】  php结合redis实现高并发下的抢购、秒杀功能的实例  javascript中的数组方法有哪些_如何利用数组方法简化数据处理  laravel怎么为API路由添加签名中间件保护_laravel API路由签名中间件保护方法  如何快速上传自定义模板至建站之星？  node.js报错：Cannot find module 'ejs'的解决办法  Laravel怎么集成Log日志记录_Laravel单文件与每日日志配置及自定义通道【详解】  学生网站制作软件,一个12岁的学生写小说，应该去什么样的网站？  佛山企业网站制作公司有哪些,沟通100网上服务官网？  如何用IIS7快速搭建并优化网站站点？  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱？  Android GridView 滑动条设置一直显示状态(推荐)  如何快速搭建安全的FTP站点？  桂林网站制作公司有哪些,桂林马拉松怎么报名？  LinuxCD持续部署教程_自动发布与回滚机制  实例解析Array和String方法  Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】  Laravel如何处理表单验证？（Requests代码示例）  Mybatis 中的insertOrUpdate操作  Laravel队列由Redis驱动怎么配置_Laravel Redis队列使用教程  Chrome浏览器标签页分组怎么用_谷歌浏览器整理标签页技巧【效率】  Laravel如何实现本地化和多语言支持？（i18n教程）  标题：Vue + Vuex 项目中正确使用 JWT 进行身份认证的实践指南  简单实现Android文件上传  Laravel如何升级到最新的版本_Laravel版本升级流程与兼容性处理  如何快速启动建站代理加盟业务？  如何基于PHP生成高效IDC网络公司建站源码？  PHP 500报错的快速解决方法  在线教育网站制作平台,山西立德教育官网？  Laravel如何实现数据导出到CSV文件_Laravel原生流式输出大数据量CSV【方案】  php485函数参数是什么意思_php485各参数详细说明【介绍】  Laravel如何实现数据库事务？（DB Facade示例）  Laravel怎么实现支付功能_Laravel集成支付宝微信支付  如何用wdcp快速搭建高效网站？  如何在IIS7上新建站点并设置安全权限？  北京网页设计制作网站有哪些,继续教育自动播放怎么设置？  网站制作公司哪里好做,成都网站制作公司哪家做得比较好，更正规？  *服务器网站为何频现安全漏洞？  Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】  Laravel广播系统如何实现实时通信_Laravel Reverb与WebSockets实战教程  油猴 教程,油猴搜脚本为什么会网页无法显示？  Laravel如何优化应用性能？（缓存和优化命令）  php做exe能调用系统命令吗_执行cmd指令实现方式【详解】  开心动漫网站制作软件下载,十分开心动画为何停播？  JS实现鼠标移上去显示图片或微信二维码  绝密ChatGPT指令：手把手教你生成HR无法拒绝的求职信