.NET单元测试初始化HttpContext报httpBrowserCapabilities空错误如何解决

问题原因 #

你当前手动初始化HttpContext的方式确实存在属性缺失问题：.NET Framework 原生的HttpContext存在大量依赖的内置属性，仅构造基础的HttpRequest、HttpResponse对象并不会自动填充这些属性，你手动逐个补充很容易出现遗漏，导致连续抛出空参数异常。

解决方案 #

方案1：修补现有初始化逻辑（适合无法调整业务代码依赖的场景） #

你直接new HttpBrowserCapabilities()后抛异常，是因为该对象的Capabilities属性没有初始化，需要手动填充基础配置，修改后的InitializeSession代码如下：

public static HttpSessionState InitializeSession()
{
    var httpRequest = new HttpRequest("", "http://localhost/", "");
    // 补全Browser属性及必填配置
    var browserCaps = new HttpBrowserCapabilities
    {
        Capabilities = new System.Collections.Hashtable
        {
            {"browser", "FakeTestBrowser"},
            {"version", "1.0"},
            {"majorversion", 1},
            {"minorversion", 0},
            {"platform", "WinNT"},
            {"isMobileDevice", false}
        }
    };
    httpRequest.Browser = browserCaps;
    // 按需补充其他用到的请求属性，比如UserAgent
    httpRequest.UserAgent = "UnitTestAgent/1.0";

    var stringWriter = new StringWriter();
    var httpResponse = new HttpResponse(stringWriter);
    var httpContext = new HttpContext(httpRequest, httpResponse);

    HttpContext.Current = httpContext;
    HttpContext.Current.Items.Clear();
    HttpSessionState session = (HttpSessionState)ReflectionHelper.Instantiate(typeof(HttpSessionState), new Type[] { typeof(IHttpSessionState) }, new FakeHttpSessionState());

    HttpContext.Current.Items.Add("AspSession", session);
    // 若业务用到身份认证，可在此处补充HttpContext.Current.User配置
    return session;
}

如果后续仍有类似空参数异常，按照上述逻辑补充对应属性的初始化即可。

方案2：改用抽象依赖+Mock（更推荐的单元测试实践） #

直接构造原生HttpContext的测试成本很高，建议将业务代码中对HttpContext的依赖调整为依赖HttpContextBase抽象类，用Moq直接Mock所需的属性，完全避免手动构造真实HttpContext的繁琐配置，示例代码如下：

[Test]
public void Test_MethodUnderTest()
{
    // Mock所需的所有HttpContext相关对象
    var mockContext = new Mock<HttpContextBase>();
    var mockRequest = new Mock<HttpRequestBase>();
    var mockSession = new Mock<HttpSessionStateBase>();

    // 按需配置用到的属性，无需关心无关的内置字段
    mockRequest.Setup(r => r.Browser).Returns(new HttpBrowserCapabilities {
        Capabilities = new Hashtable { {"browser", "Fake"} }
    });
    mockSession.Setup(s => s["YourSessionKey"]).Returns("TestValue");
    mockContext.Setup(c => c.Request).Returns(mockRequest.Object);
    mockContext.Setup(c => c.Session).Returns(mockSession.Object);

    // 将Mock后的上下文传入业务方法，或者赋值给对应服务的上下文属性
    MethodUnderTest(mockContext.Object, param1, param2, param3);
    // 后续执行断言逻辑
}

该方案耦合度更低，后续调整测试场景的成本远低于手动构造真实HttpContext。

内容的提问来源于stack exchange，提问作者The Inquisitive Coder