单元测试中设置HttpContext.Current.Request.QueryString遇空引用问题排查

你遇到的这个空引用错误，核心原因是单元测试环境下HttpContext.Current、Request这些Web环境特有的对象默认都是null，直接操作QueryString自然会触发异常。下面给你两种实用的解决思路，帮你模拟出可用的HttpContext环境，让测试代码正常运行。

方法一：手动构建完整HttpContext依赖链 #

这种方式适合想要完全掌控底层对象创建细节的场景，一步步手动搭建所需的所有对象：

[Test]
public async Task GetMaintainKitsTest()
{
    // 1. 构造需要的QueryString参数集合
    var queryParams = new NameValueCollection
    {
        {"page", "1"},
        {"pageSize", "10"}, // 按需添加业务代码用到的其他参数
        {"sortBy", "CreateTime"},
        {"sortOrder", "Desc"}
    };

    // 2. 创建模拟的HttpRequest对象
    var request = new HttpRequest("", "http://localhost/test", queryParams.ToString());

    // 3. 创建HttpResponse对象（HttpContext初始化必须依赖它）
    var response = new HttpResponse(new StringWriter());

    // 4. 初始化HttpContext.Current
    HttpContext.Current = new HttpContext(request, response);

    // 现在可以安全调用Test方法了
    var result = Test();

    // 后续添加你的断言验证逻辑...
}

方法二：用Moq框架优雅模拟（推荐） #

如果你的项目已经引入了Moq库，用它来模拟HttpContext会更简洁，也更符合现代单元测试的最佳实践：

首先确保你已安装Moq包（通过NuGet：Install-Package Moq 或.NET CLI：dotnet add package Moq）

然后编写测试代码：

using Moq;
using System.Web;
using System.Web.Routing;

[Test]
public async Task GetMaintainKitsTest()
{
    // 构造测试用的QueryString参数
    var queryString = new NameValueCollection
    {
        {"page", "1"}
    };

    // 模拟HttpRequestBase对象
    var mockRequest = new Mock<HttpRequestBase>();
    mockRequest.Setup(r => r.QueryString).Returns(queryString);

    // 模拟HttpContextBase对象
    var mockContext = new Mock<HttpContextBase>();
    mockContext.Setup(c => c.Request).Returns(mockRequest.Object);

    // 将模拟的上下文赋值给HttpContext.Current，适配业务代码的直接调用
    HttpContext.Current = new HttpContext(mockRequest.Object, new HttpResponse(new StringWriter()));

    // 调用业务方法
    var result = Test();

    // 添加断言逻辑...
}

额外优化建议 #

其实从可测试性角度来说，直接依赖HttpContext.Current并不是最佳设计，它会让代码和Web环境强绑定，难以测试和复用。建议重构业务代码，通过依赖注入的方式传递请求参数，比如：

// 重构后的业务方法，接收IQueryCollection参数
public static string Test(IQueryCollection query)
{
    var page = query["page"];
    var pageSize = query["pageSize"];
    // ... 其他参数获取逻辑
    if (!StandardRegister.AppServices.Security.Authenticator.VerifyAuthentication())
    {
        return null;
    }
    // ... 后续业务逻辑
}

这样在单元测试时，你只需要传入一个模拟的IQueryCollection，完全不需要处理HttpContext的问题，测试会更简单可靠。

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