Nginx 处理超长 Cookie 导致的 400 错误

400 Bad Request
Request Header Or Cookie Too Large

http {
    # 增大初始缓冲区到 4KB
    client_header_buffer_size 4k;
    # 设置大请求头缓冲区：4个8KB缓冲区（最大32KB）
    large_client_header_buffers 4 8k;
    # 或者更大（根据实际需求）
    # large_client_header_buffers 8 16k;  # 最大128KB
    include /etc/nginx/conf.d/*.conf;
}

server {
    listen 80;
    server_name example.com;
    # 为该站点单独设置更大的限制
    client_header_buffer_size 8k;
    large_client_header_buffers 4 16k;
    location / {
        proxy_pass http://backend;
    }
}

// 前端：避免存储过多数据到 Cookie
// ❌ 错误做法：将大量数据存 Cookie
document.cookie = "userData=" + JSON.stringify(hugeObject);
// ✅ 正确做法：Cookie 只存会话ID，数据存 localStorage/后端
document.cookie = "sessionId=" + sessionId;  // 仅少量关键数据

server {
    listen 80;
    server_name example.com;
    # 删除特定的超大 Cookie（正则匹配）
    if ($http_cookie ~* "oversized_cookie=[^;]+") {
        set $new_cookie $http_cookie;
        # 复杂处理需要 Lua 模块或外部脚本
    }
    # 或使用第三方模块 ngx_http_rewrite_module 清理
    more_clear_headers Cookie;  # 需要 headers-more-nginx-module
}

server {
    listen 80;
    access_by_lua_block {
        local cookie = ngx.var.http_cookie
        if cookie and #cookie > 8192 then  -- Cookie 超过 8KB
            -- 只保留必要的会话 Cookie
            local new_cookie = ngx.re.match(cookie, "session=[^;]+")
            if new_cookie then
                ngx.req.set_header("Cookie", new_cookie[0])
            end
        end
    }
    proxy_pass http://backend;
}

large_client_header_buffers 4 8k;
# 含义：
# - 4：缓冲区数量（最多同时处理4个大请求头）
# - 8k：每个缓冲区大小
# - 总容量 = 4 × 8k = 32KB（单个请求头最大）

# 查看 Nginx 错误日志确认问题
tail -f /var/log/nginx/error.log
# 典型错误信息：
# client sent too long header line: "Cookie: ..."

# 发送大 Cookie 测试
curl -H "Cookie: $(python3 -c 'print("x="+"A"*10000)')" \
     http://your-site.com

nginx -T | grep -E "(client_header|large_client)"

# ❌ 危险配置：容易遭受缓冲区溢出攻击
large_client_header_buffers 100 1m;  # 100MB 总缓冲！

# 同时配置请求限制
http {
    limit_req_zone $binary_remote_addr zone=req_limit:10m rate=10r/s;
    server {
        limit_req zone=req_limit burst=20 nodelay;
        large_client_header_buffers 4 16k;
    }
}