Node.js/Express获取客户端IP报错：无法读取undefined的headers属性

错误根源 #

你把获取请求IP的逻辑放错了位置：app.listen()的回调函数不接收request和response参数，它的回调是在服务器启动成功时触发的，根本没有请求上下文，所以你定义的request变量是undefined，自然会抛出Cannot read property 'headers' of undefined错误。

正确实现方式 #

要在每次请求时获取客户端IP，需要用Express的中间件/路由处理器，这些函数才会接收有效的req（请求对象）和res（响应对象）。

基础实现代码 #

const express = require('express');
const app = express();
const port = 3000;

// 全局中间件：处理所有请求的IP获取
app.use((req, res, next) => {
  // 优先取反向代理传递的真实IP，再取直接连接的IP
  let clientIp = req.headers['x-forwarded-for'];
  if (clientIp) {
    // x-forwarded-for可能包含多个IP（格式：客户端IP, 代理1IP, 代理2IP...），取第一个
    clientIp = clientIp.split(',')[0].trim();
  } else {
    clientIp = req.headers['x-real-ip'] || 
               req.ip || 
               req.connection.remoteAddress || 
               req.socket.remoteAddress;
  }

  console.log(`[${new Date()}] 客户端IP: ${clientIp}`);
  next(); // 必须调用next()，让请求继续往下走
});

// 示例路由
app.get('/', (req, res) => {
  res.send('服务运行正常');
});

// 启动服务器，回调仅用于确认启动状态
app.listen(process.env.PORT || port, () => {
  console.log(`服务器已启动，端口：${process.env.PORT || port}`);
});

反向代理场景优化 #

如果你的服务部署在反向代理（如Nginx、CDN）之后，需要先配置Express信任代理，这样req.ip会自动解析为客户端真实IP：

// 信任代理服务器（生产环境建议指定具体的代理IP，比如app.set('trust proxy', '192.168.1.0/24')）
app.set('trust proxy', true);

app.use((req, res, next) => {
  // 此时req.ip直接就是客户端真实IP
  console.log(`[${new Date()}] 客户端IP: ${req.ip}`);
  next();
});

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