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命令行参数。适用版本见本文说明。