# 上游在读取响应头时发送了过大的头

- **ID:** `nginx/upstream-sent-too-big-header-while-reading-response-header`
- **领域:** nginx
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 85%

## 根因

上游服务器发送的HTTP响应头超过了proxy_buffer_size或large_client_header_buffers的限制，通常由大型cookie或自定义头引起。

## 版本兼容性

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

## 解决方案

1. ```
   在location块中将proxy_buffer_size增加到8k或更大：proxy_buffer_size 8k; proxy_buffers 8 8k;
   ```
2. ```
   优化上游应用以减少头部大小，例如限制cookie大小或移除不必要的自定义头部
   ```
3. ```
   作为最后手段关闭proxy_buffering：proxy_buffering off;（增加内存但绕过缓冲区限制）
   ```

## 无效尝试

- **** — proxy_buffer_size must be increased in the server/location context; also proxy_buffers number may need adjustment. (70% 失败率)
- **** — This controls client headers, not upstream response headers; it's irrelevant. (90% 失败率)
- **** — The issue is on the upstream server side, not client side; cache clearing doesn't help. (95% 失败率)