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

- **ID:** `nginx/proxy-request-body-too-large-for-buffering`
- **领域:** nginx
- **类别:** runtime_error
- **验证级别:** ai_generated
- **修复率:** 85%

## 根因

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

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| nginx 1.24.0 | active | — | — |
| nginx 1.22.1 | active | — | — |
| nginx 1.20.2 | active | — | — |

## 解决方案

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.
   ```

## 无效尝试

- **** — client_max_body_size only limits the client request body size; the proxy buffer error is about how nginx forwards the body to upstream. (90% 失败率)
- **** — Disabling buffering forces nginx to hold the entire body in a single buffer; if the body exceeds proxy_buffer_size, the error persists. (70% 失败率)
- **** — proxy_buffering controls response buffering from upstream, not request body buffering to upstream. (95% 失败率)