proxy_read_timeout仅控制Nginx收到响应头后等待响应体数据到达的最大空闲时长，超时返回504；需按业务路径在location中差异化配置，并同步调大proxy_send_timeout、send_timeout，后端超时应设为Nginx值的0.8倍，流式接口需关闭缓冲。
proxy_read_timeout 不是用来“延长整个请求时间”的开关，它只控制一件事：Nginx 已收到后端响应头（如 HTTP/1.1 200 OK 和所有 headers）之后，等待响应体数据到达的**最大空闲时长**。超时即断开连接，返回 504 Gateway Timeout。
按业务路径精准设值，别全局一刀切
同一套后端可能同时处理登录接口（毫秒级）和报表导出（数分钟），不能共用一个 timeout。必须用 location 隔离配置：
- 普通 API（如
/api/user、/health）：保持proxy_read_timeout 20或默认值，利于快速失败和前端降级 - 明确长响应路径（如
/api/export、/downloads/.*\.(pdf|zip)）：在对应location块中单独设置更高值 - 数值参考真实监控：取该路径近 7 天 P95 或 P99 耗时 × 1.2～1.5。例如 P99 是 240 秒 → 设为 300 秒较稳妥
三个关联参数必须同步调大
只改 proxy_read_timeout 很可能白忙——连接会在其他环节被切断：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
-
proxy_send_timeout ≥ proxy_read_timeout：确保 Nginx 有足够时间把大请求体（如带 token 的导出参数、XML 文件）完整发给后端 -
send_timeout ≥ proxy_read_timeout：防止用户网络差、下载慢，Nginx 在转发响应体时提前关掉客户端连接 - upstream 块启用连接复用：
keepalive 32，并配proxy_http_version 1.1和proxy_set_header Connection ''，避免每次重连消耗资源
后端超时必须比 Nginx 小，留出缓冲空间
若后端自身超时设得比 Nginx 还长，会出现“后端已静默断连，Nginx 还在等”，最终报 502 或 504：
- 推荐后端超时 = Nginx
proxy_read_timeout× 0.8 左右（例如 Nginx 设 300 秒，后端设 240 秒） - 检查框架配置：Spring Boot 的
server.tomcat.connection-timeout、Flask 的timeout、Gunicorn 的--timeout - 后端不要提前
WriteHeader或flush空响应；应等真正有数据或确定超时时，再一次性写出 header + body
流式接口需额外关闭缓冲
对导出 Excel、SSE、实时日志等流式响应，Nginx 默认缓存整块响应再吐给客户端，容易造成“卡住假超时”：
- 加
proxy_buffering off;：让 Nginx 边收边转，不等待完整响应 - 可加
chunked_transfer_encoding on;：支持分块传输，提升大响应兼容性 - 注意：proxy_read_timeout 此时控制的是两次数据帧之间的最大静默间隔，不是会话总时长
