Nginx 官方不支持 limit_request_fields 指令；可通过调小 client_header_buffer_size 和 large_client_header_buffers 间接限制请求头总大小，触发 400 错误；精确计数需用 OpenResty + Lua 实现。

macOS 下 Nginx 本身不支持直接通过 limit_request_fields 指令限制请求头数量——这个指令并不存在于官方 Nginx 中（包括 macOS 上通过 Homebrew 安装的主流版本）。

为什么没有 limit_request_fields？

Nginx 官方核心模块中，没有名为 limit_request_fields 的配置指令。你可能混淆了以下两个真实存在的、但用途不同的指令：

• large_client_header_buffers：控制单个请求头的最大缓冲区大小和数量，间接影响可接受的请求头总长度与个数；
• client_header_buffer_size：设置读取客户端请求行和首部的初始缓冲区大小。

如何间接限制请求头数量？

虽然不能精确限制“字段个数”，但可通过调小缓冲区参数，让 Nginx 在收到过多或过长请求头时直接返回 400 Bad Request：

• client_header_buffer_size 1k;：将初始缓冲设为 1KB（默认通常 4KB 或 8KB），更易触发溢出；
• large_client_header_buffers 2 1k;：最多使用 2 个缓冲区，每个 1KB，即最多处理约 2KB 的请求头数据；
• 当请求头总大小超过 2 × 1k = 2KB，或单个字段超长导致无法存入任一缓冲，Nginx 就会拒绝请求。

注意：字段数量不是硬性计数，而是受字段名长度、值长度、冒号空格等共同影响。例如 50 个短字段（如 X-Id: 1）可能只占几百字节，而一个超长 Cookie 就可能占几 KB。

验证是否生效

可借助 curl 构造多请求头测试：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

curl -H "X-A: 1" -H "X-B: 2" -H "X-C: 3" ... http://localhost/

逐步增加 -H 参数，观察是否返回 400。也可用 Python 脚本批量生成大量 Header 测试边界。

替代方案：用 Lua 或 OpenResty（进阶）

若真需精确计数（比如限制最多 64 个请求头），需引入 nginx-lua-module（如通过 OpenResty）：

• 在 access_by_lua_block 中遍历 ngx.req.get_headers()；
• 检查 table.maxn 或手动计数，超限时调用 ngx.exit(400)。

Homebrew 安装 OpenResty 后，配置方式与标准 Nginx 类似，但需启用 Lua 模块并重写部分逻辑。