大文件上传需协同配置Nginx缓冲与超时参数：client_max_body_size设为2048m防413；client_body_buffer_size设128k~512k平衡内存与临时文件；proxy_buffers等配合后端响应缓冲；延长client_body_timeout、proxy_read_timeout至3600秒；指定可写且空间充足的client_body_temp_path；并同步调整后端上传限制与超时。

处理大文件上传时，Nginx 默认的缓冲区和超时设置容易导致 413 Request Entity Too Large、408 Request Timeout 或连接被重置。关键不是单纯调大某个参数，而是协调 client_body_buffer_size、client_max_body_size、proxy_buffering、proxy_buffers、proxy_busy_buffers_size 和 proxy_buffer_size 这几项，同时注意与后端服务（如应用服务器）的配置匹配。

控制客户端请求体大小和缓冲行为

这两项决定 Nginx 是否接收并暂存上传数据：

• client_max_body_size：必须设为大于目标文件上限（例如 2G），否则在读取请求头阶段就返回 413；写成 2048m 或 2g 均可，但不能用 2G（单位区分大小写）
• client_body_buffer_size：设为略大于常见单次 TCP 包（如 128k～512k）。若上传文件 ≤ 此值，Nginx 在内存中处理；超过则写入临时文件（路径由 client_body_temp_path 指定）。不建议设得过大，避免内存压力

配置代理转发时的缓冲区链路

当启用 proxy_pass，Nginx 作为反向代理，需单独设置转发给后端时的缓冲策略：

• proxy_buffering on：保持开启（默认），让 Nginx 缓冲后端响应；上传场景下它不影响请求体转发，但影响整体稳定性
• proxy_buffers 8 128k：分配 8 个缓冲区，每个 128KB，用于暂存从后端收到的响应数据（非上传请求体）；上传过程本身不走这里
• proxy_busy_buffers_size 256k：限制最多有多少缓冲区可处于“正在发送给客户端”状态；应 ≥ 单个 proxy_buffer 大小，通常设为总 proxy_buffers 容量的 1/2～2/3
• proxy_buffer_size 4k：专用于缓存后端响应头，无需调大

配合超时与临时文件路径

大文件上传耗时长，必须延长相关超时，并确保临时目录可写且空间充足：

• client_header_timeout 60、client_body_timeout 3600：分别控制读取请求头和请求体的超时；后者建议 ≥ 预估最大上传时间（如 1 小时）
• proxy_read_timeout 3600：后端处理上传完成后的响应超时，也需同步延长
• client_body_temp_path /var/tmp/nginx/client_body 1 2：指定临时文件存储路径；1 2 表示两级哈希子目录，避免单目录文件过多；确保该路径磁盘空间足够、权限为 nginx worker 可写

后端与协议层面的协同要点

Nginx 的配置只是链路一环，还需检查：

• 后端应用（如 Python Flask、Node.js、Java Spring）自身的上传大小限制（如 Flask 的 MAX_CONTENT_LENGTH）和读取超时
• 若使用 HTTPS，OpenSSL 缓冲或 TLS 握手超时一般不影响大上传，但需确认证书未过期、ALPN 协商正常
• 避免在 location 块中错误地启用 proxy_http_version 1.0；应始终用 1.1 支持 keepalive 和 chunked transfer
• 上传接口建议用 POST，不要在 URL 中携带大量参数，防止触发 large_client_header_buffers 限制