Nuxt3 Server Middleware无法获取客户端IP问题求助

核心原因 #

在Nuxt（尤其是Nuxt 3）中，若未正确配置代理信任规则，getRequestIP或直接读取socket.remoteAddress会因请求经过代理层（或框架内部处理逻辑）无法拿到真实IP，最终返回undefined。

解决步骤 #

1. 配置Nuxt信任代理 #

在nuxt.config.ts中添加代理信任配置，让Nuxt识别可信代理，从而正确解析客户端IP：

export default defineNuxtConfig({
  server: {
    trustProxy: true // 也可指定具体可信IP范围，比如['127.0.0.1', '::1']
  }
})

若部署环境使用Nginx、Cloudflare等反向代理，需将代理IP加入trustProxy列表，确保Nuxt能从X-Forwarded-For请求头中读取真实IP。

2. 修正IP获取逻辑 #

配置完成后，调整中间件代码，优先使用Nuxt内置方法，同时兼容代理场景和本地开发：

export default defineEventHandler((event) => {
  // 优先用Nuxt内置工具获取IP
  const ipAddress = getRequestIP(event) 
  // 代理场景下从请求头读取
  || event.node.req.headers['x-forwarded-for']?.split(',')[0].trim()
  // 本地开发 fallback
  || event.node.req.socket.remoteAddress 
  || 'unknown'

  // 本地访问限制逻辑
  const allowedIps = ['127.0.0.1', '::1', 'localhost']
  // 也可放开局域网IP段，根据需求调整
  if (!allowedIps.includes(ipAddress) && !ipAddress.startsWith('192.168.')) {
    throw createError({
      statusCode: 403,
      statusMessage: 'Forbidden: 仅允许本地访问'
    })
  }
})

3. 开发环境验证要点 #

本地测试时，确保请求直接发送到Nuxt开发服务器（默认http://localhost:3000），避免经过额外代理工具。注意::1是IPv6本地回环地址，需加入允许列表。

额外提示 #

• 若使用Nuxt 2，需在serverMiddleware相关配置中处理代理信任，或改用req.connection.remoteAddress获取IP。
• 生产环境部署时，务必确保反向代理正确传递X-Forwarded-For、X-Forwarded-Proto这类请求头，否则IP解析会失效。

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