在xUnit测试中如何模拟Cookie并完成读取操作？

问题原因 #

单元测试环境默认不会初始化业务代码依赖的HttpContext.Request对象的Cookie集合，所以直接读取会返回null，需要手动构造测试用的Http上下文并注入到被测对象中。

解决方案 #

方案1：手动构造DefaultHttpContext（无第三方依赖）

适合被测对象是Controller的场景，直接使用ASP.NET Core内置的DefaultHttpContext添加测试Cookie即可：

// 初始化测试上下文
var testHttpContext = new DefaultHttpContext();
// 添加你需要的测试Cookie
testHttpContext.Request.Cookies.Append("XXXX", "预期的测试Cookie值");

// 给被测Controller赋值上下文
var testController = new 你的Controller类名();
testController.ControllerContext = new ControllerContext
{
    HttpContext = testHttpContext
};

// 调用业务方法执行测试
var result = testController.你的业务方法名();
// 此处写断言逻辑

方案2：基于Moq构造依赖（适合业务服务类场景）

如果你的业务代码是通过IHttpContextAccessor注入的方式获取HttpContext，用Moq框架快速构造依赖即可：

// Mock IHttpContextAccessor
var mockAccessor = new Mock<IHttpContextAccessor>();
var testHttpContext = new DefaultHttpContext();
testHttpContext.Request.Cookies.Append("XXXX", "预期的测试Cookie值");
mockAccessor.Setup(a => a.HttpContext).Returns(testHttpContext);

// 将mock后的服务注入到你的业务类中
var testService = new 你的业务类名(mockAccessor.Object);

// 调用业务方法执行测试
var result = testService.你的业务方法名();
// 此处写断言逻辑

注意事项 #

• 如果业务中使用了加密Cookie，测试时要么用相同的加密逻辑生成测试Cookie值，要么在测试环境关闭Cookie加密配置，避免读取到的值不符合预期。
• 禁止在业务代码中通过静态方式（比如HttpContext.Current）获取上下文，这种写法强耦合无法做单元测试，统一使用IHttpContextAccessor注入的方式获取HttpContext。

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