proxy_read_timeout在大数据报表+长轮询混合场景中，精准控制Nginx收到响应头后等待下一段数据（如事件、进度块）的最大空闲时间，需按路径配置（如location ^~ /api/v1/report/subscribe）、设为后端单次挂起最大时长×1.1～1.2（如45秒），并同步调大proxy_send_timeout、send_timeout，启用HTTP/1.1、Connection透传及upstream keepalive，且须对齐后端context超时与云LB idle timeout。
proxy_read_timeout 在大数据报表 + 长轮询混合场景中，不是简单“设大就行”，而是要精准匹配后端挂起逻辑、Nginx 协议行为与客户端协作节奏。它真正控制的，是 Nginx 已收到响应头后，等待下一段响应数据（比如一个事件、一行日志、一个进度块）到达的最大空闲时间——不是整个请求时长，也不是建连或发请求的时间。
为什么报表导出 + 长轮询容易触发 504？
这类接口常采用“流式响应 + 分段推送”模式：
- 后端先返回
200 OK和Content-Type: text/event-stream或Transfer-Encoding: chunked； - 接着每隔几秒写入一条进度消息（如
data: {"progress": 35}\n\n）或最终文件流； - 若两次写入间隔超过
proxy_read_timeout，Nginx 就判定“上游无响应”，主动断连 → 前端收到 504。
典型错误日志：
upstream timed out (110: Connection timed out) while reading response header from upstream
注意：这行日志其实说明超时发生在响应头还没回来时，和长轮询无关；真正长轮询超时的日志是：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
upstream timed out (110: Connection timed out) while reading upstream
——这才是 proxy_read_timeout 生效的位置。
必须在 location 块中单独配置
报表轮询路径通常有明确前缀，例如 /api/v1/report/subscribe 或 /events/export-progress。必须用 location 精确匹配，避免影响其他短接口：
location ^~ /api/v1/report/subscribe {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Connection '';
proxy_read_timeout 45;
proxy_send_timeout 45;
send_timeout 45;
}-
^~表示前缀匹配，优先级高，适合 API 路径； -
proxy_read_timeout 45：后端最长挂起 40 秒 → Nginx 留 5 秒缓冲； -
proxy_send_timeout和send_timeout同步设为 45，防止请求未发完或客户端下载慢时被误断。
必须同步启用连接复用与协议透传
长轮询高频建连会快速耗尽 worker 连接数。不配以下三项，proxy_read_timeout 再准也白搭：
-
proxy_http_version 1.1：启用 HTTP/1.1，支持持久连接； -
proxy_set_header Connection ''：清空Connection: close，让 Nginx 不主动关闭连接； -
upstream块中开启keepalive 32：复用后端 TCP 连接，减少握手开销。
示例 upstream：
upstream backend {
server 127.0.0.1:8000;
keepalive 32;
}后端与客户端必须对齐，否则单边调优无效
-
后端：不能提前
WriteHeader()，也不能在 handler 开头就 flush 空响应；应使用带 timeout 的 context 控制单次等待（如 Go 中context.WithTimeout(ctx, 40*time.Second)），且该值 <proxy_read_timeout（建议小 5 秒）； -
客户端：浏览器 fetch 需禁用自身 timeout，例如：
fetch('/api/v1/report/subscribe', { signal: AbortSignal.timeout(0) // 或设为 60000+ }); - 云负载均衡器：阿里云 SLB、腾讯云 CLB、AWS ALB 默认 idle timeout 是 60 秒，若它在 Nginx 之前断连，所有 Nginx 配置都无效。需同步调大 LB 层超时。
不建议盲目设成 300 秒或 0
- 设
0（禁用超时）：会导致僵死连接长期占用 worker，易引发too many open files； - 设
300：后端若每 30 秒推一次进度，Nginx 等待窗口却拉到 5 分钟，资源浪费且掩盖真实瓶颈； - 推荐值：按后端单次最大挂起时间 × 1.1～1.2，常见取值为 35–60 秒，兼顾稳定性与资源效率。
