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 此时控制的是两次数据帧之间的最大静默间隔，不是会话总时长