# 413 负载过大：请求实体过大，最大大小为 1048576 字节

- **ID:** `api/rest-api-request-body-too-large-streaming`
- **领域:** api
- **类别:** resource_error
- **验证级别:** ai_generated
- **修复率:** 90%

## 根因

HTTP 请求体超过了服务器配置的最大负载大小限制，通常用于文件上传或大型 JSON 负载。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| HTTP/1.1 RFC 7231 | active | — | — |
| Nginx 1.24 | active | — | — |
| Express.js 4.18 | active | — | — |

## 解决方案

1. ```
   通过移除不必要的字段或使用分页来减小负载大小。示例：使用分块上传或分块传输编码发送数据：curl -X POST https://api.example.com/upload -H 'Transfer-Encoding: chunked' -d @largefile.json
   ```
2. ```
   增加服务器端最大负载大小限制（如果您控制服务器）。示例 (Nginx)：client_max_body_size 10m; (Express.js)：app.use(express.json({limit: '10mb'}));
   ```

## 无效尝试

- **** — Compressing the request body (e.g., gzip) may not reduce size below the limit if the server counts uncompressed bytes. (50% 失败率)
- **** — Splitting the request into multiple smaller requests without proper sequencing may cause data inconsistency or missing data. (40% 失败率)