Nginx 反向代理超时与缓冲调优实践笔记
【摘要】 最近在一次网关压测里,上游接口偶发 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)