开启 proxy_buffering 时，nginx 会先接收后端响应并写入内存缓冲区，随后立即向后端发送 200 ok 确认信号，使后端能尽早释放连接处理新请求；关闭该功能后，nginx 必须等待后端完全传输完整个响应体才能开始向客户端转发数据，这会显著增加后端连接的持有时间。对于高并发场景，开启缓冲能极大提升吞吐量并降低后端压力，而关闭缓冲则适用于需要实时流式传输或避免 nginx 内存占用过高的特定场景。
开启 proxy_buffering 时的连接释放机制是怎样的
当 proxy_buffering on 生效时，Nginx 作为中间代理，会在收到后端响应的头部后立即分配内存缓冲区（默认通常为 4k/8k），并将后续的数据块暂存在磁盘或内存中。一旦 Nginx 成功接收了后端响应的状态行和所有头部信息，它就会立即向后端服务器返回一个隐式的 200 OK 或 100 Continue 确认，告知后端“我已经准备好接收剩余数据了，你可以断开或继续发送”。这意味着后端服务器不需要等待 Nginx 将数据全部发送给最终用户，从而可以更快地释放数据库连接或应用线程去处理其他请求。这种机制的核心优势在于解耦了后端生成数据的速度与客户端消费数据的速度，防止慢速客户端拖垮后端服务。
server {
listen 80;
server_name example.com;
location /api/data {
# 显式开启缓冲（默认即为 on）
proxy_buffering on;
# 设置单个缓冲区大小
proxy_buffer_size 4k;
# 设置响应缓冲区数量和大小
proxy_buffers 8 8k;
proxy_pass http://backend_server;关闭 proxy_buffering 时的数据传输流程有何不同
当配置 proxy_buffering off 时，Nginx 的行为转变为纯粹的透传模式。此时，Nginx 不会在本地缓存后端响应的任何部分，而是建立一条从后端到客户端的直接管道。只有当后端服务器将整个响应体完全发送完毕，并且 Nginx 也成功将其全部转发给客户端后，Nginx 才会向后端发送完成信号。如果客户端的网络速度很慢，或者响应体非常大，Nginx 与后端之间的连接将被长时间占用。在这种模式下，后端的连接池资源会被迅速耗尽，因为每个正在被缓慢下载的请求都会独占一个后端连接，直到传输结束。因此，关闭缓冲通常仅用于对延迟极度敏感且数据量极小的场景，或者用于实现类似 SSE (Server-Sent Events) 的实时流式推送，确保数据能以最快速度无阻塞地到达客户端，而不受 Nginx 内部缓冲策略的影响。
server {
listen 80;
server_name example.com;
location /stream/data {
# 关闭缓冲，启用透传
proxy_buffering off;
# 禁用缓存以配合缓冲关闭
proxy_cache off;
# 保持长连接以便持续传输
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_pass http://backend_server;大文件下载场景中 proxy_buffering 对内存的影响如何
在处理几 GB 的大文件下载时，如果 proxy_buffering 处于开启状态，Nginx 会将超出内存缓冲区大小的数据自动转储到临时文件中（由 proxy_temp_file_max_size 控制）。虽然这保护了 Nginx 进程的内存不被撑爆，但会导致大量的磁盘 I/O 操作，可能成为性能瓶颈。相反，如果关闭缓冲，Nginx 完全不使用临时文件，而是直接将数据流通过内核 socket 传递给客户端，这极大地减少了磁盘读写开销，降低了 CPU 中断频率。然而，关闭缓冲意味着 Nginx 进程本身不占用额外内存来存储响应体，但会长时间占用后端连接。在实际生产环境中，对于静态大文件，通常建议直接使用 location ~* \.(zip|mp4|iso)$ 并通过 root 指令直接提供文件，绕过 proxy_pass，从而彻底避免代理缓冲带来的复杂性和性能损耗；若必须通过代理，开启缓冲并合理设置 proxy_max_temp_file_size 是更稳妥的选择，以防止内存溢出，同时利用磁盘缓存加速重复请求。
