Next.js Server Action无法获取客户端请求的问题咨询

问题根源 #

你当前的写法是把API路由的参数逻辑套在了Server Action上——Server Action并非通过NextRequest参数接收请求上下文，直接声明这个参数只会得到undefined，因为它的调用机制是RPC而非标准HTTP路由。

正确获取客户端请求信息的方式 #

Next.js 为Server Action提供了专门的函数来获取请求上下文，无需从客户端传递任何可伪造的参数：

1. 获取客户端真实IP #

使用requestIP()函数可以直接拿到客户端的真实IP（部署在反向代理/CDN后也能正确获取，Next.js会自动处理头信息）。

2. 获取完整请求头 #

使用headers()函数可以获取所有请求头信息，用于更复杂的上下文判断。

修改后的服务端代码示例：

'use server';

import { headers, requestIP } from 'next/headers';

export async function Test() {
  // 获取客户端IP
  const clientIp = requestIP();
  // 获取请求头集合
  const requestHeaders = headers();

  console.log('客户端真实IP:', clientIp);
  console.log('请求头:', Object.fromEntries(requestHeaders));

  // 基于IP实现限流逻辑示例（伪代码）
  // const redisKey = `rate_limit:${clientIp}`;
  // const requestCount = await redis.incr(redisKey);
  // if (requestCount === 1) await redis.expire(redisKey, 60); // 1分钟过期
  // if (requestCount > 5) throw new Error('请求过于频繁，请稍后再试');
}

关键说明 #

• requestIP()和headers()只能在Server Action/Server Component中调用，属于Next.js的服务端上下文API，完全安全，不会被客户端篡改。
• 限流逻辑建议结合Redis等缓存工具实现，避免用内存存储（多实例部署时会失效）。

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