Next.js SSR下Nginx因请求头过大返回400错误，需调大client_header_buffer_size和large_client_header_buffers配置，并禁用proxy_buffering、透传必要Header，辅以前端精简Cookie与Token。

Next.js 在 SSR（服务端渲染）模式下，当 Nginx 作为反向代理时，若客户端请求头过大（例如含长 Cookie、大量自定义 Header 或认证 Token），Nginx 默认的 large_client_header_buffers 和 client_header_buffer_size 限制会触发 400 Bad Request 错误（如 400 Request Header Or Cookie Too Large）。解决关键是合理调大 Nginx 对请求头的缓冲区配置，而非修改 Next.js 或 Node.js 层。

调整 Nginx 请求头缓冲区大小

Nginx 默认单个请求头缓冲区为 1KB，最多支持 4 个缓冲区（共 4KB）。对于含长 JWT、多域名 Cookie 或调试 Header 的 SSR 请求，很容易超限。需在 Nginx 配置的 http 或 server 块中显式扩大：

• client_header_buffer_size 2k;：提升单个请求行和首行 Header 的初始缓冲区（建议设为 2K–4K）
• large_client_header_buffers 4 8k;：允许最多 4 个缓冲区，每个 8KB（总上限 32KB），足以覆盖常见长 Cookie 场景
• client_max_body_size 10m;（可选）：虽不直接影响 Header，但 SSR 表单提交或 API 路由可能涉及大 body，一并检查

确认 Next.js SSR 请求路径未被错误缓存或截断

Nginx 若对 SSR 路由（如 /api/*、/_next/data/* 或动态路由如 /post/[id]）启用了不合适的缓存或 proxy_buffering，也可能干扰 Header 传递。确保 SSR 相关 location 块中：

• 禁用 proxy_buffering on;（SSR 响应流式输出，建议设为 off）
• 设置 proxy_set_header Host $host; 和 proxy_set_header X-Real-IP $remote_addr; 等必要透传头
• 避免对 / 或动态路由使用 try_files 回退到静态文件——这会绕过 Node.js SSR，导致 Header 未被处理就报错

精简客户端请求头（辅助优化）

治标更需治本。前端可通过以下方式减少 Header 体积：

• Cookie 拆分：将非 SSR 必需的字段（如埋点 ID、UI 设置）移入 localStorage，避免随每次请求发送
• Token 精简：后端签发 JWT 时控制 payload 字段数量；前端使用 short-lived Token + refresh 机制，避免 Token 越来越长
• 移除冗余 Header：检查 Axios/Fetch 是否默认注入了重复或调试用 Header（如 X-Debug-Token）

验证与排查步骤

修改 Nginx 后务必验证生效：

• 执行 nginx -t 检查语法，再 nginx -s reload 平滑重载
• 用 curl -v -H "Cookie: $(python3 -c 'print(\"A\"*6000)')" http://your-domain.com/ 模拟长 Cookie 请求，观察是否仍返回 400
• 查看 Nginx error log：tail -f /var/log/nginx/error.log，确认无 client intended to send too large body 或 request header or cookie too large 报错
• 对比请求前后 curl -I 输出，确认 Header 被完整接收（如通过日志中间件打印 req.headers）