设为0可免除重度磁盘io对nginx事件循环的阻塞，它禁用proxy_pass响应体溢出时写临时文件环节，避免高并发下随机小io、inode频繁创建删除及内核调度延迟。
设为 0 是免除重度磁盘 IO 对 Nginx 事件循环阻塞最直接有效的配置，但它不是“关磁盘”，而是精准禁用 proxy_pass 响应体溢出时写临时文件这一环节——该环节在高并发下极易引发随机小 IO、inode 频繁创建/删除和内核调度延迟，从而拖慢整个 worker 进程的事件处理能力。
为什么这个值能缓解事件循环阻塞
当后端返回中等大小响应（如 200KB–5MB），而内存缓冲不足时，Nginx 默认会反复执行「写一块 → 等客户端读走 → 再读一块 → 清理文件」流程。每个动作都触发系统调用（write、read、unlink），在高 QPS 下显著增加内核上下文切换与 I/O 等待，导致 epoll_wait 返回变慢、定时器延迟、连接超时堆积——表现为 wa% 高、await 飙升、nginx_http_request_duration_seconds 尾部延迟突增。
设为 0 后，这部分逻辑被跳过：Nginx 要么把响应全塞进内存转发，要么直接流式边收边发，彻底绕开磁盘路径，释放事件循环对 IO 调度的依赖。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
必须同步调优的三项缓冲参数
单独设 0 会导致大量 502 或连接重置，因为事件循环虽不卡了，但 worker 却因无法缓存而丢包。需确保内存缓冲能覆盖典型负载：
-
proxy_buffer_size 16k：专存响应头，避免长 JWT、多 Set-Cookie 截断； -
proxy_buffers 16 64k：总缓冲容量达 1MB，适配 JSON/API/HTML 类响应； -
proxy_busy_buffers_size 256k：预留足够空间接力转发，防止 busy 状态阻塞接收，避免事件循环卡在 buffer 竞争上。
更轻量的替代方案：关闭缓冲 + 流式背压
若业务允许端到端低延迟直通（如微服务间 gRPC-Web、SSE、OpenTelemetry trace 上报），可进一步降低事件循环负担：
-
proxy_buffering off：完全跳过响应缓存，收到即转发，proxy_max_temp_file_size失效； -
proxy_buffers 2 4k+proxy_busy_buffers_size 4k：构成轻量级背压机制——一旦接收 >4KB 且未及时发出，Nginx 主动暂停读上游，避免内存暴涨拖垮事件循环； -
tcp_nodelay on+proxy_read_timeout 5s：收紧链路，减少无效等待。
务必排除其他 IO 干扰源
即使 proxy_max_temp_file_size=0 生效，以下行为仍会阻塞事件循环：
-
访问日志同步刷盘：默认每次写都
fsync，改用access_log ... buffer=64k flush=1s； -
大文件上传落盘：检查
client_body_in_file_only是否启用，调大client_body_buffer_size并设off； -
error_log 级别过低：debug 级日志爆炸式写入会抢占 CPU 和 IO，建议不低于
warn； -
DNS 缓存持久化：避免
resolver ... valid=30s类配置，防止写/var/cache/nginx。
