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
相关产品推荐
相关产品推荐

