从.NET Framework迁移至.NET 6：如何用Moq模拟响应Cookies？

问题背景 #

从.NET Framework迁移单元测试到.NET 6时，原代码通过Mock<HttpResponse>返回HttpCookieCollection模拟响应Cookies，但.NET 6中HttpResponse.Cookies的类型已改为IResponseCookies，不再支持HttpCookieCollection。目前请求Cookies已通过RequestCookieCollection完成适配，需改写响应Cookies的模拟逻辑。

原代码问题点 #

原模拟代码依赖.NET Framework特有的HttpCookieCollection：

var response = new Mock<HttpResponse>();
response.Setup(r => r.Cookies).Returns(new HttpCookieCollection());

.NET 6中该类型已移除，直接使用会导致编译错误，需替换为适配IResponseCookies的模拟方式。

改写方案 #

方案1：Mock IResponseCookies接口 #

直接模拟IResponseCookies接口，若需要验证Cookie的添加操作，可设置回调或验证逻辑：

// 模拟IResponseCookies
var responseCookies = new Mock<IResponseCookies>();
// 可选：验证是否添加了指定Cookie
responseCookies.Setup(c => c.Append(It.IsAny<string>(), It.IsAny<string>(), It.IsAny<CookieOptions>()))
              .Callback<string, string, CookieOptions>((key, value, options) => 
              {
                  // 这里可以添加断言或记录逻辑
              });

var response = new Mock<HttpResponse>();
response.Setup(r => r.Cookies).Returns(responseCookies.Object);
response.Setup(r => r.Headers).Returns(new HeaderDictionary());

方案2：使用DefaultHttpContext构建真实上下文 #

更简便的方式是使用DefaultHttpContext，它自带已初始化的Request和Response对象，包含正确的IResponseCookies实现，无需单独Mock每个属性：

var context = new DefaultHttpContext();
// 设置请求QueryString
context.Request.QueryString = new QueryString("?login=error");
// 设置请求Cookies
context.Request.Cookies.Append("sampleCookieKey", "sampleCookieValue");
// 响应Cookies已自动初始化，可直接在测试后验证

完整改写后的单元测试示例 #

以下是使用DefaultHttpContext的简化版本，代码更简洁且贴近真实运行环境：

[TestMethod]
public void SampleTest()
{
    // 使用DefaultHttpContext替代Mock，简化上下文构建
    var context = new DefaultHttpContext();
    
    // 设置请求QueryString
    context.Request.QueryString = new QueryString("?login=error");
    // 设置请求Cookies
    context.Request.Cookies.Append("sampleCookieKey", "sampleCookieValue");
    
    // 初始化控制器上下文
    var ctrl = new SampleController("blah blah");
    var actionContext = new ActionContext(context, new RouteData(), new ControllerActionDescriptor());
    ctrl.ControllerContext = new ControllerContext(actionContext);

    // 执行测试方法
    var res = ctrl.SendTemplate("123", "true", _encryptor.Encrypt(user).Token);
    
    // 验证结果
    Assert.IsNotNull(res);
    Assert.IsTrue(res is EmptyResult);
    
    // 可选：验证响应Cookies是否符合预期（如果业务逻辑会添加Cookie）
    // Assert.IsTrue(context.Response.Cookies.ContainsKey("expectedCookieKey"));
}

如果仍需使用Moq模拟HttpResponse，可参考方案1的写法替换原响应Cookies的模拟逻辑。

内容的提问来源于stack exchange，提问作者Ashutosh Gupta