超时参数需按角色分层设值：客户端侧、代理侧、连接生命周期各管一段；client_header_timeout和client_body_timeout分别控制HTTP头和请求体接收耐心，普通页面设10s，大文件上传设30s/300s，移动端设60s/60s；proxy_read_timeout须匹配后端P95响应时间并加20%余量；流式接口需关闭缓冲且proxy_read_timeout≥3600；keepalive_timeout和keepalive_requests需按服务类型差异化配置以防连接堆积；proxy_connect_timeout建议5s～15s，send_timeout可压至30s；所有timeout单位支持s/ms，但部分不支持毫秒精度；修改后必须nginx -t校验并reload生效。
直接说结论：超时参数不是统一调大或调小，而是按角色分层设值——客户端侧、代理侧、连接生命周期各管一段，配错一个就丢请求或卡死 worker。
client_header_timeout 和 client_body_timeout 怎么设才不丢请求
这两个值控制 Nginx 接收请求的“耐心程度”。client_header_timeout 是等完整 HTTP 头的时间，client_body_timeout 是等请求体（比如文件上传数据）两次 TCP 包之间的最大空闲时间。
- 普通 HTML/JS/CSS 页面：
client_header_timeout 10s、client_body_timeout 10s足够，弱网用户一般也能在 10 秒内发完头和小 body - 含大文件上传的后台系统（如 CMS 表单）：
client_header_timeout 30s（防 TLS 握手延迟），client_body_timeout 300s（5 分钟支持百 MB 断点续传） - 移动端 App 接口：
client_header_timeout 60s、client_body_timeout 60s更稳妥，中间代理重传或蜂窝网络抖动容易拖慢 header 到达 - 注意：
client_body_timeout不是整个上传耗时上限，而是“两次数据包间隔不能超该值”，断续上传必须满足这个节奏
proxy_read_timeout 必须匹配后端真实 P95 响应时间
proxy_read_timeout 是反向代理场景下最常误配的参数。它不是“整个请求最长等多久”，而是“Nginx 从 upstream 开始读响应起，连续等待数据的最大时长”。一旦超时，直接返回 504 Gateway Time-out。
- 先用
curl -w "@format.txt" -o /dev/null -s http://your-api测后端接口真实 P95 值（比如 82s），再加 20% 余量 → 设为proxy_read_timeout 100s -
proxy_send_timeout可设为60s，它极少触发，只在 upstream 拒绝接收请求（如 socket 写阻塞）时起作用，没必要比proxy_read_timeout还大 - 流式接口（SSE、导出 CSV 流）必须关缓冲：
proxy_buffering off，且proxy_read_timeout至少设3600，否则连接中途被断
keepalive_timeout 和 keepalive_requests 容易引发连接堆积
keepalive_timeout 控制的是“空闲长连接存活多久”，不是“请求处理时限”；keepalive_requests 是单条连接最多服务几个请求。两者配不当，会悄无声息吃光 worker_connections。
- 静态资源服务（CDN 类）可设
keepalive_timeout 75s、keepalive_requests 100，复用率高 - 动态 API 服务建议
keepalive_timeout 30s、keepalive_requests 50，避免慢客户端长期占着连接不放 -
keepalive_timeout只能在http或server块里配，location级无效 —— 很多人在这儿白改配置 - 浏览器实际保持连接时间可能比 Nginx 设的小（如 Chrome 最多 60s），设太高没意义
别漏掉 proxy_connect_timeout 和 send_timeout
proxy_connect_timeout 是 Nginx 连 upstream 的建连超时，send_timeout 是 Nginx 发响应给客户端的超时。它们不像前几个那么显眼，但线上故障常源于此。
-
proxy_connect_timeout建议设5s～15s，太长会让失败上游拖住 worker；后端挂了又没健康检查时，这个值就是止损关键 -
send_timeout默认 60s，高并发下可压到30s，防止弱网客户端拉长连接占用资源 - 所有 timeout 单位都支持
s（秒）、ms（毫秒），但client_header_timeout等不支持毫秒级精度，写100ms会被当0处理
真正难的不是记住每个参数含义，而是理解它们生效的边界：哪个在 client ↔ nginx 段起作用，哪个在 nginx ↔ upstream 段生效，哪个只影响空闲连接。改完必须用 nginx -t 校验 + nginx -s reload 生效，别信“改完自动热更”。
