Nginx上游响应头过大:502错误排查

适用范围:Nginx HTTP反向代理或FastCGI;仅在已经出现对应日志时使用本篇。

访问普通页面正常,登录或跳转时返回502,而Nginx错误日志出现 upstream sent too big header while reading response header from upstream,要检查的是应用返回给Nginx的响应头,不是浏览器发来的请求头。

把 large_client_header_buffers 一路加大,可能改错方向。先保留出错时间、路径、上游地址和对应日志,再确认处理请求的模块。

分清哪段链路与哪个方向

先确认Nginx进程实际使用的程序与配置路径,再检查对应的磁盘配置:

sudo nginx -T

面板环境不一定使用系统路径里的nginx,先核实程序路径及启动时的-c、-p参数。nginx -T输出的是本次检查读取的磁盘文件,不能单凭它证明运行中的进程已加载这些修改;还要核对最近一次成功重载的记录及实际响应。输出只在本机查看,分享时删去上游凭据、私网地址和其他站点信息。[3]

请求交给谁 对应检查
通过proxy_pass访问HTTP应用 proxy_buffer_size及相关proxy缓冲配置
通过fastcgi_pass访问PHP-FPM fastcgi_buffer_size及相关fastcgi缓冲配置
浏览器请求本身的Cookie过大 客户端请求头限制,属于另一方向

这两类上游模块都有用于读取响应最初部分的缓冲区,通常包含响应头。超出该部分可接受范围时,Nginx可能把响应视为无效;不是把响应正文缓存关掉就一定能修复。[1][2]

先查为什么响应头突然变大

使用测试账号重复一次相同操作,在受控环境检查应用发出的头信息。重点看是否重复设置大量 Set-Cookie、会话令牌是否膨胀、Location 是否拼接了不断增长的参数,以及某个调试中间件是否追加异常长字段。

不要把完整Cookie或令牌写进公开日志。需要测量时,记录字段名、数量和总长度即可。HEAD请求与GET响应可能不同;未登录请求也不一定产生同样的Cookie,不能拿它们代替实际出错路径。

若上游本身已经反复重定向或创建异常会话,应先修复应用。单纯提高Nginx限制,可能只把错误推迟到浏览器或下一层代理。

仅对确认需要的入口调整缓冲

保存原配置后,在测试环境按实际头长度选择适度上限。以下仅是HTTP代理链路中的配置示例,合并到已确认的location,不新增另一套站点:

proxy_buffer_size 16k;
proxy_buffers 8 16k;
proxy_busy_buffers_size 32k;

16k不是通用答案。先确认该响应确实可以容纳,同时检查已有配置的继承关系与参数约束,再对实际实例执行配置检查。不要全站照抄很大的数值;并发请求下的内存开销也需要评估。

FastCGI场景使用对应的 fastcgi_buffer_size、fastcgi_buffers 等参数,不能把proxy配置写进去后就认为PHP请求也已改变。[2]

复测不能只看首页

配置检查通过后再按发布流程重载,重复原来失败的登录、跳转、退出及普通请求,核对错误日志和进程内存。确认浏览器正确收到预期的Cookie,而不是丢掉认证字段后暂时没有502。

保留原配置方便回退。需要协助时提供出错时间、相关日志、实际处理模块、响应头数量与长度,以及脱敏后的相关配置片段;不用发送会话令牌。

继续排查

网站502或504错误:Nginx与PHP-FPM排查;网站提示请求头或Cookie过大怎么办;Nginx反向代理本地Web应用。

技术依据:[1] Nginx proxy响应缓冲配置;[2] Nginx FastCGI响应缓冲配置;[3] Nginx命令行参数。适用版本见本文说明。