nginx响应截断分header和body两类：header超限看proxy_buffer_size，body截断查proxy_buffers或磁盘缓冲；需通过错误日志、curl对比、tcpdump抓包及$upstream_http_content_length日志精准定位。
后端响应被截断，多数情况是 Nginx 代理层缓冲区容量不足导致的“静默失败”——不报错、不超时，但客户端收到不完整响应体（如 JSON 缺字段、HTML 渲染异常、CSV 导出少行）。核心不是调大所有 buffer，而是分清 header 截断还是 body 截断，再精准扩容。
先确认到底是哪部分被截断
盲目调参前，必须定位问题类型：
- 查 Nginx 错误日志：upstream sent too big header → 响应头（Header）超限，问题在 proxy_buffer_size
- 查响应内容：用
curl -i http://api/ | head -c 50000 | wc -c对比后端直连结果，若明显偏短且无错误日志 → 响应体（Body）被截断，问题在 proxy_buffers 或磁盘临时缓冲 - 抓包验证：用
tcpdump -i lo port 80或 Wireshark 观察 Nginx 发给客户端的 TCP payload 长度是否卡在 4K、8K、32K 等整数边界 → 实锤缓冲区硬限制 - 加日志字段：在 log_format 中加入
$upstream_http_content_length，对比该值与实际返回字节数差值，可量化截断程度
针对性调大 proxy_buffer_size（解决 Header 截断）
该参数只管响应头，和响应体无关。默认 4k 对现代应用普遍不够：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 实测响应头总长（
curl -v http:// 2>&1 | grep '^）若 ≥ 4096，就需调整 - 常见安全取值：16k（适配 JWT + 多 Cookie）、32k（OAuth2 回调、链路追踪头密集场景）
- 必须放在
location或server块中，且写在proxy_pass之前 - HTTP/2 用户额外检查
http2_max_field_size（默认也是 4k），它独立限制 HPACK 解码后的单字段长度
合理扩容 proxy_buffers（解决 Body 截断）
这是响应体缓冲主力，但不能靠“堆数量”或“拍脑袋设 64k”：
- 计算依据：从后端日志或 Prometheus 拉取目标接口的 P95 响应体大小，设
proxy_buffers 数量 × 单块大小 ≥ P95 × 1.2 - 示例：P95 是 28KB →
proxy_buffers 8 4k（32KB 总量）足够；若 P95 是 400KB → 改为proxy_buffers 16 32k（512KB） - 配套必须设
proxy_busy_buffers_size：建议为总量的 1/4～1/2，且 ≥ 单块大小（如 32k），否则后端还在发、Nginx 却卡住不收 - 避免设
proxy_max_temp_file_size 0：该值为 0 会禁用磁盘缓冲，超内存直接截断；建议设为1024m并确保proxy_temp_path所在磁盘有空间
不推荐但可应急的选项
这些是权宜之计，上线前务必评估副作用：
-
proxy_buffering off;：绕过所有内存缓冲，边收边转。适合导出类接口，但会丢失响应头控制（如无法统一加 CORS）、无法合并小包、增加后端连接压力 - 仅对特定路径关闭缓冲：
location /export { proxy_buffering off; }，比全局关闭更可控 - 不建议长期依赖“一律调成 16 64k”：浪费内存，且可能掩盖后端返回异常大响应的真实问题（如未分页、全量 dump）
