ASP.NET Core控制器单元测试：如何Mock HttpRequest请求对象？

嘿，我完全懂你现在的困扰——给ASP.NET Core的ApiController写单元测试时，要验证请求头里的令牌逻辑，但自己实例化控制器时Request对象直接是null，而且它还是只读属性没法硬塞值，之前找的老WebApi例子又完全不适用.NET Core，确实挺头疼的。

我给你分享两个在.NET Core里亲测有效的方案，能完美解决这个问题：

方案一：手动模拟ControllerContext（纯单元测试） #

ASP.NET Core里的控制器Request属性其实是从ControllerContext.HttpContext.Request来的，所以我们可以通过给控制器设置自定义的ControllerContext来模拟请求环境：

1. 先创建一个DefaultHttpContext实例，这是ASP.NET Core提供的默认HttpContext实现
2. 在这个HttpContext的Request.Headers里添加你需要测试的令牌
3. 把这个HttpContext赋值给控制器的ControllerContext属性

代码示例如下：

// 先Mock你的数据访问接口（你已经做好这一步啦）
var mockRepository = new Mock<IYourDataAccessInterface>();
// 实例化控制器
var testController = new YourApiController(mockRepository.Object);

// 创建模拟的HttpContext和请求头
var mockHttpContext = new DefaultHttpContext();
// 添加Authorization令牌，格式根据你的实际逻辑调整
mockHttpContext.Request.Headers["Authorization"] = "Bearer test-token-123";

// 给控制器设置ControllerContext
testController.ControllerContext = new ControllerContext
{
    HttpContext = mockHttpContext
};

// 现在调用控制器的Action，就能正常读取Request.Headers了
var actionResult = testController.YourActionMethod();

如果你的控制器还用到了User属性（比如从令牌解析用户信息），还可以顺便模拟ClaimsPrincipal：

// 给HttpContext设置模拟的用户身份
mockHttpContext.User = new ClaimsPrincipal(new ClaimsIdentity(new[]
{
    new Claim(ClaimTypes.NameIdentifier, "test-user-id"),
    new Claim(ClaimTypes.Name, "test-user")
}, "mock-authentication"));

方案二：用WebApplicationFactory做集成测试 #

如果你的测试需要更接近真实运行环境（比如要测试路由、中间件、过滤器等完整流程），可以用ASP.NET Core官方提供的WebApplicationFactory来创建测试客户端，直接发送带请求头的HTTP请求：

// 假设你的项目启动类是Program（.NET 6+的顶级语句模式）
using var factory = new WebApplicationFactory<Program>();
var testClient = factory.CreateClient();

// 设置请求头的令牌
testClient.DefaultRequestHeaders.Authorization = 
    new AuthenticationHeaderValue("Bearer", "test-token-123");

// 发送请求到你的Api端点
var response = await testClient.GetAsync("/api/your-endpoint");
// 验证请求是否成功
response.EnsureSuccessStatusCode();

这个方法会启动一个轻量级的测试服务器，模拟真实的HTTP请求流程，适合端到端的集成测试。

总结 #

• 纯单元测试选方案一，速度快，专注测试控制器本身的逻辑
• 需要测试完整请求流程选方案二，更贴近真实场景

这两种都是.NET Core官方推荐的测试方式，比老版本WebApi那种Mock HttpRequestMessage的方法简单太多啦。

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