C#怎么进行XUnit单元测试_C#如何编写Mock模拟数据【必备】-C#.Net教程-PHP中文网

在C#中快速运行xUnit测试需安装xunit和xunit.runner.visualstudio包，测试类和方法须满足public、无参构造、无返回值及相应特性；Mock HttpClient应避免直接Mock，改用接口或HttpMessageHandler模拟。

c#怎么进行xunit单元测试_c#如何编写mock模拟数据【必备】

必须先确认：xUnit本身不带运行器，.NET SDK 6+ 项目默认支持 dotnet test，但得装对包。常见失败不是代码写错，而是漏了依赖。

确保项目文件（.csproj）里有和（后者是让VS能识别测试的关键）
测试类必须是 public，且不能有构造函数参数（除非用 [Collection] 管理共享状态）
测试方法必须是 public、无返回值（void 或 Task）、带 [Fact] 或 [Theory] 特性；命名无所谓，但别用中文或空格
执行命令直接用 dotnet test，不用额外启动服务——如果提示“no test is available”，八成是没装 xunit.runner.visualstudio 或目标框架不匹配（比如测试项目用了 net6.0，但被测项目是 net472）

这是 .NET Core/.NET 5+ 下最典型的 Mock 失败场景：直接对 HttpClient 实例调用 new Mock() 会报错，因为 HttpClient 类型被设计为不可继承（sealed），Moq 无法生成代理。

正确做法是面向接口编程：把 HTTP 调用封装进一个接口（如 IHttpService），再让实现类内部使用 HttpClient
或者改用 HttpMessageHandler 模拟——创建 Mock，重写 SendAsync 方法，再传给 HttpClient 构造函数：new HttpClient(mockHandler.Object)
注意：HttpClient 实例本身不该被 Mock，它是协调者；真正要隔离的是网络行为，不是它本身
如果你用的是 Refit 或 Flurl，优先 Mock 它们的接口（如 IGitHubApi），而不是碰 HttpClient

Setup 是基础，但很多真实场景需要多次调用返回不同值（比如分页请求、重试逻辑），这时候硬写多个 Setup 会覆盖，必须用 SetupSequence。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

Setup(x => x.GetById(1)).Returns("A")：只要参数是 1，永远返回 "A"
SetupSequence(x => x.NextId()).Returns(100).Returns(101).Returns(102)：第一次调用返回 100，第二次 101，第三次起都返回 102
如果被测逻辑里有多线程调用同一个 Mock 方法，SetupSequence 不保证线程安全，此时应改用 Callback + 外部计数器（如 int counter = 0; Setup(x => x.Get()).Callback(() => counter++).Returns(() => values[counter])）
别对 void 方法用 Returns，要用 Callback 捕获调用参数做验证

很多人写 Assert.Throws(() => service.Do(null)) 后发现测试通过，但其实异常根本没被抛出——是因为委托体里发生了其他异常（比如 NRE），而 Assert.Throws 只认指定类型，其余一概当失败。

务必确认你捕获的异常类型和实际抛出的一致：ArgumentException ≠ ArgumentNullException，基类异常不会匹配子类断言
异步方法必须用 Assert.ThrowsAsync，写成 Assert.Throws(async () => await ...) 会导致编译失败（委托类型不匹配）
如果想检查异常消息，不要链式调用 .Message.Contains(...)，而应该先接收异常对象：var ex = Assert.Throws(() => ...); Assert.Equal("expected", ex.Message);
在 xUnit 中，Assert.Throws 内部会吞掉异常堆栈；如需调试，临时改成直接调用并用 try/catch 打印 ex.ToString()