Nginx作为API网关通过client_max_body_size限请求体大小，配合缓冲、超时及代理配置支持分片上传，但分片逻辑需后端实现；需协同限流、校验与安全策略保障稳定性。
在使用 Nginx 作为 API 网关时，对请求体（request body）进行大小限制和分片处理，核心目标是保障服务稳定性、防止资源耗尽，并兼容大文件上传场景。Nginx 本身不直接支持“分片上传”的业务逻辑（如合并、校验、断点续传），但可通过配置 + 后端协同实现分片接收与限流控制。关键在于：限大小靠内置指令，分片靠协议约定与后端配合，Nginx 起的是边界守门员作用。
一、精准控制请求体大小：client_max_body_size
这是最基础也最关键的配置，用于拒绝超限请求，避免后端被恶意或误用的大 payload 拖垮。
- 作用范围灵活：可在 http、server、location 块中设置，越靠近 location 级别优先级越高，适合为不同接口（如普通表单 vs 文件上传）设置差异化限制。
-
单位明确：支持 k（KB）、m（MB）、g（GB），例如
client_max_body_size 100m;表示允许最大 100MB 的请求体。 -
错误响应可控：超出限制时 Nginx 默认返回
413 Request Entity Too Large，可配合error_page 413 /upload_limit_exceeded.html;返回友好提示页。
二、配合分片上传：合理设置缓冲与超时
分片上传本质是将大文件拆成多个小 HTTP 请求（如每片 5MB），每个请求独立发送。Nginx 需确保这些小请求能稳定抵达后端，而非被缓冲或中断。
-
关闭请求体缓冲（重要）：设置
client_body_buffer_size 128k;控制内存缓冲区大小；若分片较大（如 5MB），建议设为略大于单片大小（如6m），避免频繁写临时文件；同时启用client_body_in_file_only off;（默认），防止意外落盘影响性能。 -
延长读取超时：分片上传可能因网络慢导致单个请求传输时间长，需调大
client_header_timeout和client_body_timeout（例如设为60s），避免 Nginx 在接收过程中主动断连。 -
禁用上游代理缓冲（如转发到后端）：在 proxy_pass 场景下，添加
proxy_buffering off;和proxy_request_buffering off;（Nginx 1.13.10+），确保分片请求以流式方式透传，不被 Nginx 缓存整块再发。
三、安全加固：结合其他限流与校验机制
仅靠 size 限制不够，需组合策略防范重放、刷量等风险。
-
按 IP 或 Token 限速：使用
limit_req模块限制单位时间内上传请求数，例如每秒最多 5 个分片请求，防暴力上传。 -
校验分片元数据：要求客户端在请求头（如
X-Upload-ID、X-Part-Number、X-Total-Parts）携带分片信息，Nginx 可用map指令提取并透传给后端，便于后端做一致性校验。 -
过滤非法 Content-Type：在 location 中用
if ($content_type !~ "^multipart/form-data|^application/octet-stream") { return 400; }拒绝非预期类型，减少攻击面。
四、后端协同要点：Nginx 不做分片逻辑，只保通路
Nginx 是反向代理，不是应用服务器。真正的分片合并、MD5 校验、存储调度必须由后端（如 Node.js、Java Spring、Python FastAPI）完成。
-
统一上传入口路径：例如所有分片都 POST 到
/api/v1/upload/chunk，Nginx 将其负载均衡到后端集群，后端根据请求头中的唯一 ID 聚合同一文件的各分片。 -
支持跨域与预检：若前端跨域上传，Nginx 需透传或添加 CORS 头（
add_header 'Access-Control-Allow-Origin' '*';），并正确响应 OPTIONS 预检请求。 -
健康检查与失败重试：Nginx upstream 可配置
max_fails=3 fail_timeout=30s，自动剔除异常后端节点；客户端应实现分片失败后的重试逻辑，而非依赖 Nginx 重发。
