Nginx 反向代理超时与缓冲调优实践笔记

举报
yd_258808623 发表于 2026/11/16 10:45:45 2026/11/16
【摘要】 最近在一次网关压测里,上游接口偶发 504,错误日志同时出现 upstream timed out,临时目录也被大响应写成了高峰。把超时和缓冲重新拆开调了一遍,记下可复用的做法。 先把超时拆开看反向代理至少有三类超时,不建议只用一个全局数字:proxy_connect_timeout:与上游建立连接的等待时间,内网一般 5 秒足够。proxy_send_timeout:向上游发送请求体时的空...

最近在一次网关压测里,上游接口偶发 504,错误日志同时出现 upstream timed out,临时目录也被大响应写成了高峰。把超时和缓冲重新拆开调了一遍,记下可复用的做法。

先把超时拆开看

反向代理至少有三类超时,不建议只用一个全局数字:

  • proxy_connect_timeout:与上游建立连接的等待时间,内网一般 5 秒足够。
  • proxy_send_timeout:向上游发送请求体时的空闲超时。
  • proxy_read_timeout:等待上游响应的空闲超时。长查询、文件导出或 SSE 需要单独放大,否则会提前切断。

这次 504 的主因是读超时与业务不符。峰值时接口偶发十秒以上才返回首包,而该 location 仍沿用偏短的默认值。把它调整到与 SLA 对齐,并让上游处理超时略短于网关,避免网关一直挂死连接。

缓冲决定延迟和磁盘压力

开启 proxy_buffering 后,Nginx 会先把上游响应收入内存,超出后再写临时文件。几个容易踩坑的参数:

  • proxy_buffer_size 存放响应头,头部过大时会出现 upstream sent too big header。
  • proxy_buffers 决定响应体缓冲块的数量和大小,应按典型响应体估算。
  • proxy_busy_buffers_size 是向客户端发送时占用的忙碌缓冲,必须小于 buffers 总和,且大于单个 buffer。
  • proxy_max_temp_file_size 限制临时文件;设为 0 可禁止落盘,适合磁盘紧张的网关节点。

大文件下载或视频流建议在对应 location 关闭缓冲,让数据边收边转,降低首字节延迟和磁盘抖动。接口 JSON 这类小包则保持缓冲,尽快释放上游连接。

调完后怎么验收

配置 reload 之后,不要只确认 nginx -t 通过。还要对照错误日志里的 timed out、临时目录用量,以及 504 占比是否下降。同一套参数不要复制到所有 location,按接口类型分组更稳妥。遇到偶发超时时,先看是连接阶段、发送阶段还是读阶段,再决定改哪一项,避免把所有超时一起放大掩盖问题。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。