Mocked MVC Session的Verify断言失败：已调用Clear方法却未通过验证

嘿，这个问题我之前踩过好几次坑！明明调试的时候看着Session.Clear()确实执行了，但用Verify验证就是失败，大概率是Mock配置或者实例匹配的问题，给你列几个最常见的原因和排查方向：

1. Mock的Session实例和Controller实际使用的不是同一个 #

这是最常见的原因！你可能手动创建了Mock<ISession>，但没正确把它绑定到Controller的HttpContext里，导致Controller调用的是另一个Session实例（比如默认的空实例），根本不是你Mock的那个。

举个正确的配置例子（ASP.NET Core）：

// 创建Session的Mock
var mockSession = new Mock<ISession>();
// 创建HttpContext的Mock，并绑定Session
var mockHttpContext = new Mock<HttpContext>();
mockHttpContext.Setup(ctx => ctx.Session).Returns(mockSession.Object);
// 把Mock的HttpContext赋值给Controller的ControllerContext
var yourController = new YourController();
yourController.ControllerContext = new ControllerContext 
{ 
    HttpContext = mockHttpContext.Object 
};

如果这里的绑定步骤出错，比如你直接给Controller.HttpContext赋值而不是通过ControllerContext，或者没正确SetupHttpContext.Session，那Verify肯定找不到调用记录。

2. Verify的时机不对，Session实例被重置/替换了 #

比如你在执行Controller方法后，不小心重新赋值了Controller的HttpContext，或者测试框架在测试过程中自动清理了上下文，导致你Verify的是一个全新的Mock实例，自然看不到之前的调用记录。

排查技巧：在Controller方法里加一行Console.WriteLine(Session.GetHashCode())，在测试代码里加Console.WriteLine(mockSession.Object.GetHashCode())，如果两个哈希码不一样，说明实例不匹配，直接定位问题。

3. 异步方法没等待，导致Clear()还没执行就Verify了 #

如果你的Controller方法是异步的（返回async Task/async Task<IActionResult>），但测试时你直接调用方法却没加await，那异步代码可能还没执行到Session.Clear()，你就跑去Verify了，结果自然是失败。

正确的做法是一定要等待异步方法完成：

// 等待异步方法执行完毕
await yourController.YourAsyncActionMethod();
// 再执行Verify
mockSession.Verify(s => s.Clear(), Times.Once);

4. Mock的配置模式问题（比如Strict模式或Setup错误） #

如果你创建Mock时用了MockBehavior.Strict，但没提前SetupSession.Clear()方法，那调用Clear()时会直接抛出异常（如果没抛异常说明你没开Strict）。另外，要是你不小心用了SetupOnce来配置Session的方法，那第二次调用不会被跟踪，但这种情况比较少见。

另外，确保你的Mock是每个测试方法单独创建的，不要用全局共享的Mock实例，否则之前测试的调用记录会干扰当前测试的Verify结果。

5. 混淆了ASP.NET Core和Framework的Session类型 #

如果你用的是ASP.NET Framework（不是Core），那Session的类型是HttpSessionStateBase，而不是ASP.NET Core里的ISession。这时候你需要MockHttpContextBase，并设置它的Session属性为Mock<HttpSessionStateBase>的实例，而不是ISession的Mock。类型不匹配的话，Verify肯定找不到调用。

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