Nginx 如何通过配置文件中的 request_pool_size 调整请求内存池大小

Nginx 无 request_pool_size 配置指令，该说法系误传；请求级内存池初始大小由源码硬编码为约4096字节，不可配置；实际可控的是 client_header_buffer_size、client_body_buffer_size 和 connection_pool_size 等间接影响内存分配的指令。

Nginx 没有 request_pool_size 这个配置指令，它并不存在于最新配置语法中，也不会被 nginx 解析生效。

你可能看到的“request_pool_size”说法，源于对 Nginx 内存管理机制的误解或非最新文档的误传。Nginx 的请求级内存池（即每个 HTTP 请求使用的 r->pool）不提供任何运行时可配置的初始大小参数，它的创建逻辑是固定的：

1. 每个新请求开始时，Nginx 会调用 ngx_palloc_small 或内部函数分配一个初始 pool；
2. 实际初始分配量通常为 4KB（4096 字节）左右，但这不是由配置项控制，而是由源码中硬编码的默认行为决定（例如 ngx_http_create_request 中隐式调用 ngx_create_pool(4096)）；
3. 该 pool 会随请求处理动态扩容（通过 ngx_palloc_block），上限不受显式配置限制，只受系统内存与 worker 进程资源限制约束。

真正可配置、且影响请求内存行为的，是以下几类指令：

1. client_header_buffer_size

   控制解析请求头所用缓冲区大小，默认 1k；超限时启用 large_client_header_buffers，间接决定 header 相关内存分配模式。

2. client_body_buffer_size

   控制请求体在内存中缓存的最大尺寸，默认 8k 或 16k；直接影响 r->pool 中用于 body 的主要内存占用。

3. client_max_body_size

   配合 client_body_buffer_size 使用，防止过大请求耗尽内存，触发 413 错误。

4. connection_pool_size

   控制每个 TCP 连接的初始内存池大小（如 256B/512B），虽属连接级，但请求初期部分临时数据（如 early header parsing）可能从中分配，属于间接影响。

所以，如果你希望降低单请求内存开销，应聚焦于：

1. 合理设置 client_header_buffer_size 和 client_body_buffer_size，避免盲目设大；
2. 对上传接口按实际 P95 体长 ×1.25 向上取整（如 320KB → 512KB），而非统一设 1M；
3. 用 location 隔离高内存需求路径，防止污染其他路由；
4. 开启 error_log ... debug 并搜索 client request body buffered，验证是否真走内存而非落盘。

Nginx 的内存池设计强调“按需分配 + 生命周期绑定”，不是靠调一个 *_size 就能全局控住的。所谓“调 request pool 大小”，本质是调控请求过程中最消耗内存的几个 buffer 行为。