网站提示请求头或Cookie过大怎么办

网站突然提示Request Header Or Cookie Too Large,常见情况是某个浏览器无法访问,换一个新会话却正常。问题可能出在不断积累的Cookie、过长的认证头,也可能由CDN、代理或应用自己的限制触发。先找到拒绝请求的那一层,再决定清理数据还是改配置。

先确认“大”的是哪一部分

看到的线索 它指向的方向
431,或明确提示请求头、Cookie过大 检查单个请求头及全部请求头的大小;并非所有服务器都会返回431。
普通400 Bad Request 原因很多,需结合日志;Nginx的单个请求头超出缓冲也可能返回400。
413 Request Entity Too Large 通常是请求正文或上传大小,不是Cookie限制。
upstream sent too big header 这是Nginx读取上游响应头时出错,方向与浏览器发来的请求头不同。

上传相关的413按Nginx与PHP上传限制处理。不要为了Cookie错误增大client_max_body_size,也不要看到“header”就一起修改所有buffer参数。

只有一个浏览器出错,先做小范围对照

记下出错域名、页面和时间,用新建的隐私窗口访问同一个只读页面。新会话成功能缩小范围,但它也改变了登录状态和部分浏览器行为,不能单凭这一点确认Cookie就是原因。不要重复提交付款或订单请求。

在原窗口的开发者工具中查看失败请求,重点核对Cookie、Authorization及异常增长的自定义头。再查看该站点保存的Cookie名称、Domain、Path和大小,留意同名但路径不同、旧版本遗留或父域共享的数据。只记录字段名和长度,不把Cookie值、令牌或完整HAR发到公开页面。

需要清理时,先保存未提交内容,确认重新登录资料可用,再从浏览器的Cookie或站点数据设置中搜索该域名,仅删除相关站点的Cookie。此操作会使相关登录状态失效,父域共享Cookie还可能影响其子站。清理缓存文件不等于删除Cookie,也没必要清空所有网站的浏览记录。

重新登录后若很快复发,应交给应用维护者检查会话数据是否持续膨胀、退出登录是否正确清除旧Cookie,以及是否把过多业务数据或权限列表写进Cookie。客户端清理只能恢复一次访问,不能修复重复增长。

管理员要找到真正拒绝请求的入口

先按原部署方式确定Nginx实例、站点和日志路径。以下是系统安装的示例;容器或面板环境使用它实际的程序及配置参数,不直接照搬路径:

sudo nginx -T
sudo tail -n 100 /var/log/nginx/error.log

对照故障时间、域名和请求路径,寻找类似client sent too large header、client sent too long header line的记录。错误日志可能包含部分头内容,查看和转交时同样需要脱敏。没有找到记录,先检查日志范围和入口,不立即认定请求没有到达。

有CDN或多级代理时,各层都可能限制请求头。比较同一请求的入口日志和源站日志;源站设置再大,也无法改变前置服务已经拒绝的请求。不要为定位问题关闭防护或开放原本受限的源站。

日志如果是upstream sent too big header,应检查应用响应中的Set-Cookie等字段。HTTP代理相关的是proxy_buffer_size,PHP-FPM相关的是fastcgi_buffer_size;它们读取上游响应,不能修复客户端请求头过大。先缩减异常响应,后续定位可看Nginx与PHP-FPM的502排查。

正常业务确实需要时,才调整请求头上限

Nginx的client_header_buffer_size用于初始读取,放不下时会按large_client_header_buffers申请较大缓冲。后者的第一个数是缓冲数量,第二个数是单个缓冲大小;单条请求头仍受单个缓冲大小限制,增加数量不等于扩大单条Cookie头的上限。

例如已经确认正常业务存在约10KiB的单条头,而实际限制为8KiB,可在评估并发内存和各层限制后考虑下面的值。它只是调整幅度示例,不是所有网站的推荐配置:

large_client_header_buffers 4 16k;

该指令只能放在允许的http或server上下文,不能放进location。读取请求的早期阶段可能采用默认server的设置,所以只修改某个域名的server块不一定有效;应先核对同一监听地址上的默认站点及实际协议,不能盲目改成全局配置。缓冲按需分配,放大后仍可能增加高并发下的内存开销。

变更前备份真正生效的配置、记录原值,在维护窗口内只调整已确认的限制。使用同一实例的nginx -t检查通过后,按原管理方式重载,并核对错误日志。检查失败则停止;需要回退时恢复原值,检查后重载。

最后同时验证原浏览器、新会话、重新登录及正常页面,观察请求头是否仍持续变大。多级入口都应能接受合理的业务请求,但不需要为异常Cookie提供无限空间。验收看原故障是否消失及增长原因是否修复,不以“首页能打开”结束。