Nginx通过client_header_buffer_size和large_client_header_buffers两级缓冲机制处理请求头，前者设初始大小（默认1k），后者在超限时按需分配更大缓冲区（如4 8k），单个请求头不得超过后者单个buffer大小，否则返回414或400错误。
client_header_buffer_size 和 large_client_header_buffers 必须一起调
单独改 client_header_buffer_size 没用，Nginx 对 URI 长度的限制实际由 large_client_header_buffers 主导。GET 请求的整个 URL（含 query string）会被当作请求头的一部分处理，一旦超出缓冲区上限，直接返回 414 Request-URI Too Large。
常见错误现象：
- PHP 脚本根本没收到请求，Nginx 日志里出现
414状态码 - 浏览器只显示空白页或“无法访问此网站”，无明确报错
- 在 phpEnv 的 Nginx 配置中只改了
client_max_body_size，对 GET 超长无效（那是管 POST body 的）
实操建议：
-
client_header_buffer_size建议设为2k或4k（默认1k太小） -
large_client_header_buffers至少设为4 8k（即最多 4 个缓冲区，每个 8KB），URI 最大可支持约 8KB - 若需支持超长 token 或嵌套 deep-link 场景（如 OAuth callback 带大量参数），可设为
8 16k - 配置必须放在
http或server块，不能只写在location里
phpEnv 中修改 Nginx 配置的实际路径在哪
phpEnv 是 Windows 下的集成环境，其 Nginx 配置文件不在标准 Linux 路径下。默认安装后，主配置位于：
立即学习“PHP免费学习笔记（深入）”；
C:\phpenv\nginx\conf\nginx.conf
但注意：phpEnv 启动时会自动加载 conf/vhosts/ 下的虚拟主机配置，所以更稳妥的做法是——
- 在
conf/vhosts/目录下找到你当前启用的站点配置文件（如default.conf或项目名.conf） - 把
client_header_buffer_size和large_client_header_buffers放进对应server块内 - 改完必须重启 phpEnv 的 Nginx 服务（不是只点“重载”，要“停止再启动”）
- 验证是否生效：用
nginx -t手动测试配置语法（phpEnv 自带的命令行终端里可运行）
为什么改了配置还是 414？检查这三个地方
即使参数数值看起来足够大，仍返回 414，大概率卡在这几个环节：
- 配置写在了错误的作用域：比如写在
location /api里，但超长 URL 实际命中的是location /，而后者没配 - phpEnv 的 Nginx 是以 Windows 服务方式运行的，配置文件修改后未真正 reload —— 它的 GUI 界面“重载配置”按钮有时不触发完整 reload，建议用任务管理器结束
nginx.exe进程后再手动双击启动 - 浏览器或代理（如 Charles/Fiddler）自身对 URL 长度有限制：Chrome 限制约 2MB，但 IE/Edge 旧版可能仅支持 2048 字符；先用
curl测试绕过浏览器干扰：curl "http://localhost:8080/test.php?param=..."
和 PHP 层无关，但别让 $_SERVER['REQUEST_URI'] 截断
Nginx 把超长 URI 传给 PHP-FPM 是完整的，但某些 PHP 扩展或框架路由组件（如早期 Laravel 5.5 之前的 Router）会自行截断或解析失败。这不是 Nginx 配置问题，但容易误判。
验证方法：
- 写一个裸脚本
test.php，内容只有<?php var_dump($_SERVER['REQUEST_URI']); ?> - 用超长 URL 访问，看输出是否完整 —— 如果这里就变短了，说明是 PHP-FPM 或 PHP 自身限制（极少见），不是 Nginx
- phpEnv 默认使用 PHP-FPM 模式，确认
php-fpm.conf里没有request_terminate_timeout或security.limit_extensions干扰
最常被忽略的一点：phpEnv 的 Nginx 配置模板有时自带 large_client_header_buffers 4 4k，看着像够用，但 4k 缓冲 × 4 个 = 总共才 16KB，而现代 OAuth2 callback 可轻松突破 20KB。数值宁大勿小，但也要避免设成 16 64k 这类过大值，防止 DoS 类型攻击消耗内存。
