You need to enable JavaScript to run this app. Node.js v13.0.0+ req.connection废弃后Express获取客户端IP的正确实现
优惠活动
大模型
产品
解决方案
定价
更多

Node.js v13.0.0+ req.connection废弃后Express获取客户端IP的正确实现

替换废弃的req.connection获取客户端IP的实现方案

基础属性替换改动

根据Node.js v13.0.0版本的废弃规则,IncomingMessage请求对象上的connection属性已被标记为废弃,官方推荐使用功能完全等价的socket属性替代——两者指向同一个底层Socket实例,不存在任何行为差异,替换后VS Code中的TS废弃警告会自动消失。
对应原代码的修改逻辑非常直接:

// 触发ts(6385)废弃警告的原写法
const ip = req.headers['x-forwarded-for'] || req.connection.remoteAddress;

// 替换为非废弃属性的标准写法
const ip = req.headers['x-forwarded-for'] || req.socket.remoteAddress;

生产环境下获取客户端IP的正确实现

仅替换属性名不属于生产级的可用实现,需要结合常见的部署场景补全边界逻辑:

  • 适配x-forwarded-for的头格式:服务部署在反向代理后端时,该头的值是逗号分隔的多层代理IP列表,最左侧的非空IP才是真实客户端地址,不能直接将整个字符串作为IP取值
  • 配置Express可信代理规则:部署在Nginx、CDN、云负载均衡等代理组件后方时,需要在Express初始化阶段通过app.set('trust proxy', <可信代理层数>)开启信任,框架才会自动在req.ip属性中解析出真实客户端IP,否则会将代理节点的IP识别为客户端地址
  • 补全域名兼容逻辑:本地直连测试场景下,req.socket.remoteAddress可能返回::1这类IPv6本地回环地址,需要根据业务需求做适配映射

可直接复用的IP提取逻辑示例:

// Express 初始化阶段按需配置可信代理层数(按实际部署调整数值)
app.set('trust proxy', 1);

function getClientIp(req) {
  // 优先使用框架自动解析的可信IP值
  if (req.ip) return req.ip;

  // 兜底解析x-forwarded-for头
  const forwardedIpList = req.headers['x-forwarded-for']?.split(',').map(ipStr => ipStr.trim()) ?? [];
  if (forwardedIpList.length) return forwardedIpList[0];

  // 最终兜底取socket直连的远程地址
  return req.socket.remoteAddress;
}

内容的提问来源于stack exchange,提问作者Raz Buchnik

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.23 22:54:03