Next.js生产环境调用headers()报TypeError: Cannot read properties of undefined (bind)

核心原因 #

Next.js App Router中的headers()是同步函数，不需要使用await调用。开发环境的宽松校验未触发错误，但生产构建后的严格执行环境会因多余的await导致上下文异常，进而抛出bind未定义的错误。

修复步骤 #

1. 修正getIP工具函数 #

移除headers()前的await，并调整函数为同步（无需async）：

"use server"
import { headers } from "next/headers";

export function getIP() {
  const requestHeaders = headers();
  // 正确处理代理转发的IP（优先取x-forwarded-for的第一个IP， fallback到x-real-ip）
  const remoteIP = requestHeaders.get("x-forwarded-for")?.split(",")[0].trim() || 
                   requestHeaders.get("x-real-ip") || 
                   "unknown";
  return remoteIP;
}

2. 更新页面组件调用 #

由于getIP变为同步函数，页面中无需再用await：

"use server"
import { getIP } from "./_util/getIP";

export default function Home() {
  const ip = getIP();
  return (
    <h1>TEST IP {ip}</h1>
  );
}

额外排查点 #

• 确认使用的Next.js版本为稳定版（避免beta/rc版本的已知bug）
• 若使用output: 'standalone'配置，检查构建后的依赖是否完整
• 部署环境中需确保反向代理（如Nginx、Cloudflare）正确传递x-forwarded-for或x-real-ip请求头

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