如何处理 Nginx 报错：an upstream response is buffered to a temporary file

在使用 Nginx 作为反向代理时，可能会遇到以下报错：

an upstream response is buffered to a temporary file /var/cache/nginx/proxy_temp/3/00/0000000003

这表明 Nginx 在处理上游服务器返回的响应时，因响应体过大或缓冲区设置不足，将数据暂存到了磁盘上的临时文件中。这种情况可能会导致性能下降，因为磁盘 I/O 比内存操作慢得多。

问题原因

Nginx 在代理上游服务器的响应时，会先将响应数据缓存在内存中。如果响应数据的大小超过了配置的缓冲区限制，Nginx 会将超出的部分写入磁盘的临时文件。常见的原因包括：

1. 上游服务器返回的响应数据太大。
2. Nginx 缓冲区配置较小。
3. 临时文件目录磁盘空间不足。

---

解决方法

1. 增加内存缓冲区

通过调整 proxy_buffers 和 proxy_buffer_size 的配置，可以增加 Nginx 在内存中存储响应数据的能力，减少对临时文件的依赖。

http {
    # 配置缓冲区大小
    proxy_buffers 16 64k;
    proxy_buffer_size 128k;
    proxy_busy_buffers_size 256k;
}

• proxy_buffers：定义缓冲区的数量和大小，本文设置为 16 个 64KB 的缓冲区。
• proxy_buffer_size：设置用于存储响应头的缓冲区大小，这里设置为 128KB。
• proxy_busy_buffers_size：定义在缓冲区繁忙时可以使用的缓冲区大小，通常为 proxy_buffers 总大小的两倍。

2. 增大临时文件大小限制

如果响应体特别大，无法完全存储在内存中，可以增大临时文件大小的限制，确保响应可以正常缓存到磁盘。

http {
    # 设置单个临时文件的最大大小
    proxy_max_temp_file_size 512m;

    # 指定临时文件存储路径
    proxy_temp_path /var/cache/nginx/proxy_temp;
}

• proxy_max_temp_file_size：设置单个请求可以使用的临时文件的最大大小。
• proxy_temp_path：指定临时文件的存储路径。确保该路径磁盘空间充足。

3. 禁用缓冲

对于需要实时传输的响应（如流媒体、大文件下载），可以完全禁用 Nginx 的缓冲功能。

location /large-file {
    proxy_pass http://upstream_server;
    proxy_buffering off; # 禁用缓冲
}

禁用缓冲后，Nginx 会直接将上游的响应传递给客户端，而不进行缓存或缓冲。

4. 优化超时配置

针对大文件传输，可能需要增加超时时间，以防止因传输时间过长导致连接中断。

http {
    proxy_read_timeout 300s;
    proxy_connect_timeout 300s;
    proxy_send_timeout 300s;
}

• proxy_read_timeout：设置 Nginx 从上游服务器读取响应的超时时间。
• proxy_connect_timeout：设置与上游服务器建立连接的超时时间。
• proxy_send_timeout：设置发送请求到上游服务器的超时时间。

5. 优化上游服务器

在上游服务器中启用 Gzip 压缩，可以减小响应体积，从而降低对缓冲区的需求。

http {
    gzip on;
    gzip_min_length 1024;
    gzip_proxied any;
    gzip_types text/plain application/json application/javascript text/css;
}

---

完整配置示例

以下是针对大文件响应的优化配置示例：

http {
    # 增加缓冲区大小
    proxy_buffers 16 64k;
    proxy_buffer_size 128k;
    proxy_busy_buffers_size 256k;

    # 增大临时文件大小
    proxy_max_temp_file_size 512m;
    proxy_temp_path /var/cache/nginx/proxy_temp;

    # 超时设置
    proxy_read_timeout 300s;
    proxy_connect_timeout 300s;
    proxy_send_timeout 300s;

    # 启用 gzip 压缩
    gzip on;
    gzip_min_length 1024;
    gzip_proxied any;
    gzip_types text/plain application/json application/javascript text/css;

    server {
        listen 80;

        # 默认代理配置
        location / {
            proxy_pass http://upstream_server;
        }

        # 针对大文件的禁用缓冲配置
        location /large-file {
            proxy_pass http://upstream_server;
            proxy_buffering off;
        }
    }
}

---

注意事项

1. 磁盘空间监控：确保 /var/cache/nginx/proxy_temp 目录有足够的磁盘空间，防止因磁盘不足导致的错误。
2. 内存使用权衡：增大缓冲区会消耗更多的内存，需根据服务器内存大小合理配置。
3. 针对性调整：对于特定的文件或路径，可以单独配置缓冲策略，不影响其他请求。

---

总结

通过调整缓冲区大小、优化临时文件配置以及禁用缓冲等方法，可以有效解决 Nginx 报错 an upstream response is buffered to a temporary file 的问题。具体配置需根据实际场景进行优化，确保性能和资源利用的平衡。

原文地址：https://blog.csdn.net/qq_36291550/article/details/145209635

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！