工具类中调用Request.ServerVariables获取客户端IP报空引用错误

你碰到的Object reference not set to an instance of an object错误，核心原因大概率是System.Web.HttpContext.Current本身为null，或者Request对象未初始化，直接去访问ServerVariables就触发了空引用。咱们一步步来修复这个问题：

问题根源拆解 #

• 当工具类在非Web请求上下文中被调用时（比如后台定时任务、控制台程序、脱离Web请求的业务逻辑），HttpContext.Current会是null，此时访问Request自然会报错。
• 就算在Web上下文里，也可能存在Request对象未正确初始化，或者HTTP_X_FORWARDED_FOR这个请求头本身不存在的情况（比如客户端直接访问服务器，没有经过反向代理/负载均衡）。

修复后的健壮实现 #

下面是加入了层层空值检查的完整代码，同时兼顾了直接访问和经过代理的场景：

public static string GetIpAddress()
{
    string ipAddress = string.Empty;
    
    // 第一步：先确认HttpContext是否存在
    if (System.Web.HttpContext.Current == null)
    {
        return "Unknown (No HttpContext)";
    }
    
    var request = System.Web.HttpContext.Current.Request;
    
    // 优先尝试获取代理传递的客户端IP（HTTP_X_FORWARDED_FOR）
    ipAddress = request.ServerVariables["HTTP_X_FORWARDED_FOR"];
    
    // 如果代理IP不存在，直接获取服务器识别的连接IP（REMOTE_ADDR）
    if (string.IsNullOrEmpty(ipAddress))
    {
        ipAddress = request.ServerVariables["REMOTE_ADDR"];
    }
    
    // 处理HTTP_X_FORWARDED_FOR可能返回多个IP的情况（格式：客户端IP, 代理1IP, 代理2IP...）
    if (!string.IsNullOrEmpty(ipAddress) && ipAddress.Contains(","))
    {
        ipAddress = ipAddress.Split(',')[0].Trim();
    }
    
    // 最后兜底，确保不会返回空值
    return string.IsNullOrEmpty(ipAddress) ? "Unknown" : ipAddress;
}

额外注意要点 #

• 非Web上下文兼容：如果你的工具类需要在没有HttpContext的环境下使用，建议添加参数让调用方主动传递IP，或者提前判断上下文是否存在，避免报错。
• 反向代理配置：如果服务器部署在反向代理（比如Nginx、IIS ARR）后面，要确保代理服务器正确传递X-Forwarded-For请求头，否则HTTP_X_FORWARDED_FOR会是空值。
• 安全性提示：X-Forwarded-For可以被客户端伪造，如果你的场景对IP真实性要求较高，建议结合服务器的真实连接IP（REMOTE_ADDR）做校验，或者只信任已知的代理IP段。

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