解决nginx大文件上传413错误的核心是配置client_max_body_size，需在location块中精准设置（如location /api/upload { client_max_body_size 2g; }），并确保其值不大于后端限制，修改后执行nginx -s reload生效。
解决大报文与文件上传问题，要分两路处理：一是解除请求体限制（防 413），二是调优代理缓冲行为（防 502/504/卡顿）。两者目标不同，不能混设，也不能只调一个。
先放开上传体限制：client_max_body_size
这是大文件上传的“准入门槛”。默认 1MB，超了直接返回 413 错误，根本进不到缓冲环节。
- 必须写在 location 块内，精准控制上传路径，例如：
location /api/upload { client_max_body_size 2G; } - 该值需 ≤ 后端服务允许的最大请求体（如 Spring Boot 的
spring.servlet.multipart.max-request-size），否则 Nginx 放行后，后端仍会报 413 - 修改后执行
nginx -s reload生效
再调响应缓冲区：应对大 JSON、导出文件等大响应体
当后端返回几十 MB 的 JSON、Excel 或 HTML 页面时，Nginx 默认缓冲（8×4k）极易溢出，导致 502 或响应被截断。
-
响应头缓冲：用
proxy_buffer_size单独控制，建议设为64k或128k，避免长 Cookie 或自定义 Header 被截断 -
响应体缓冲池：用
proxy_buffers设置总容量和单块大小，例如：proxy_buffers 8 4m;（总 32MB，单块 4MB，适配大 JSON）
或proxy_buffers 4 16m;（更少 buffer、更大单块，降低碎片） -
忙缓冲上限：设
proxy_busy_buffers_size为单 buffer 大小的 2 倍，例如proxy_buffers 4 16m;→proxy_busy_buffers_size 32m;，防止边收边发时过早刷出中断后端
上传场景下要不要开 proxy_buffering？
上传过程本身不依赖 proxy_buffering，但它影响上传完成后的响应（如成功 JSON、重定向）。是否开启，看后端行为：
- 后端返回快、响应小（如简单 JSON）→ 保持
proxy_buffering on;更稳妥，便于统一管理 - 后端流式反馈、或返回超大响应（如日志流、SSE）→ 可关掉：
proxy_buffering off;，此时proxy_buffers等参数失效，数据直通客户端 - 若开启缓冲，还需配
proxy_max_temp_file_size 2g;，允许超内存部分写磁盘；禁用（0）易导致失败
别漏掉关键配套项
缓冲区调得再大，超时或系统层卡住照样失败：
-
proxy_read_timeout 3600;：Nginx 等待后端响应的最长时间，上传大文件时必调长 -
client_body_temp_path /var/tmp/nginx-body;：确保该路径磁盘空间充足、I/O 稳定（Nginx 默认把大请求体暂存于此） - 检查系统参数：
net.core.somaxconn和net.ipv4.tcp_max_syn_backlog建议 ≥ 65535，防连接队列溢出
