413错误不仅因请求体过大，也可能由请求头超长导致；需同时调整nginx的client_header_buffer_size和large_client_header_buffers参数，并重启服务。
413 错误不一定是文件上传太大，也可能是请求头（Request Headers）本身超长——比如带了超长的 Cookie、Authorization 或自定义 header。phpEnv 默认用 Nginx + PHP-FPM，但它的 Nginx 配置里没有显式限制请求头大小，真正卡住你的，往往是 client_header_buffer_size 和 large_client_header_buffers 这两个参数。
为什么改了 client_max_body_size 还报 413？
因为 client_max_body_size 只管请求体（Body），比如 POST 数据、上传文件；而请求头（Headers）过长会触发另一类校验：Nginx 在解析 HTTP 请求头时，若单个 header 行超过 client_header_buffer_size（默认 1k），或整个 header 块超过 large_client_header_buffers（默认 4×8k），就会直接返回 413，甚至不进日志、不打 debug 信息。
- 常见诱因：前端 SDK 自动注入超长
Cookie（如含 Base64 用户上下文）、JWT token 过大、浏览器插件加了冗余 header - 现象特征：小文件上传正常，但带特定用户登录态的请求必 413；curl -v 看得到 header 明显比其他请求长
- 注意：这个 413 不会出现在 access_log 里，只在 error_log 中有类似
client sent too large request的提示
在 phpEnv 中修改 Nginx 请求头缓冲区
phpEnv 的 Nginx 配置通常位于 /phpenv/nginx/conf/nginx.conf（Windows 下是 \phpenv\nginx\conf\nginx.conf）。你必须在 http{} 块内添加以下两行：
http {
client_header_buffer_size 4k;
large_client_header_buffers 8 64k;
# 其他原有配置...
}
-
client_header_buffer_size 4k：设为 4k 而非默认 1k，避免单行 header（如超长 Cookie）直接被拒 -
large_client_header_buffers 8 64k：表示最多支持 8 个 buffer，每个 64k，总 header 容量可达 512k —— 够应付大多数 JWT 或调试 header 场景 - 不要只改
client_max_body_size，它对 header 无效 - 改完必须重启 Nginx：
phpenv nginx restart（Windows）或sudo /phpenv/nginx/sbin/nginx -s reload（Linux/macOS）
顺便检查 PHP-FPM 是否也参与拦截
虽然 Nginx 是第一道关，但某些 phpEnv 版本会把 PHP-FPM 的 security.limit_extensions 或 request_terminate_timeout 误配成 413 相关行为。重点确认以下两点：
- PHP-FPM 的
www.conf（路径类似/phpenv/php/etc/php-fpm.d/www.conf）中，security.limit_extensions应只包含.php，不要出现.html等无关扩展，否则可能触发意外交互 - 确保没有设置
request_slowlog_timeout或request_terminate_timeout过短，这类超时一般报 504，但某些旧版 phpEnv 会伪装成 413 - 如果用了自定义
php.ini，确认里面没写max_input_vars = 100这类限制——它不会导致 413，但会让大表单提交失败且错误码混淆
真正难排查的是 header 大小问题：它不报具体哪一行超限，也不告诉你当前 header 总长。建议先用 curl 抓原始请求：curl -v -H "Cookie: $(python3 -c 'print(\"A\"*8000)')" http://localhost，逐步逼近阈值，再反推配置是否生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
