nginx runtime_error ai_generated true

代理请求体过大，无法缓冲

proxy request body too large for buffering

ID: nginx/proxy-request-body-too-large-for-buffering

其他格式: JSON · Markdown 中文 · English
85%修复率
88%置信度
1证据数
2024-03-12首次发现

版本兼容性

版本状态引入弃用备注
nginx 1.24.0 active — — —
nginx 1.22.1 active — — —
nginx 1.20.2 active — — —

根因分析

上游服务器期望 Content-Length 头部，但请求体超过 proxy_buffer_size 且缓冲被禁用，导致 nginx 无法转发请求。

English

The upstream server expects a Content-Length header, but the request body exceeds proxy_buffer_size and buffering is disabled, causing nginx to fail to forward the request.

generic

官方文档

https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffer_size

解决方案

  1. Increase proxy_buffer_size to accommodate the expected request body size, e.g., add 'proxy_buffer_size 8k;' or larger in the location or http block.
  2. Enable proxy request buffering by setting 'proxy_request_buffering on;' (default) and ensure proxy_buffer_size is at least the size of typical request bodies.
  3. If the upstream can handle chunked transfer encoding, disable the Content-Length requirement by adding 'proxy_http_version 1.1;' and 'proxy_set_header Connection "";' to allow chunked requests.

无效尝试

常见但无效的做法:

  1. 90% 失败

    client_max_body_size only limits the client request body size; the proxy buffer error is about how nginx forwards the body to upstream.

  2. 70% 失败

    Disabling buffering forces nginx to hold the entire body in a single buffer; if the body exceeds proxy_buffer_size, the error persists.

  3. 95% 失败

    proxy_buffering controls response buffering from upstream, not request body buffering to upstream.