根本原因是Nginx与PHP多层限制未同步调整：必须在server/location块中配置client_max_body_size（如512M），同时调大php.ini中post_max_size（≥512M）和upload_max_filesize（如500M），并设置max_input_time与max_execution_time为600秒，且确保upload_tmp_dir权限正确、空间充足、路径可写。
phpEnv 环境下 Nginx 处理超大 POST 请求失败，根本原因不是 phpEnv 本身有问题，而是 Nginx 和 PHP 的默认限制在请求链路上层层拦截——必须同步调大三处关键配置，缺一不可。
client_max_body_size 必须显式写在 server 或 location 块里
Nginx 默认只允许 1MB 的请求体，超了直接返回 413 Request Entity Too Large，请求根本不会到达 PHP。很多人把 client_max_body_size 500M 写在 http 块里，结果没生效，因为 phpEnv 的站点配置通常走的是独立 server 块或 location ~ \.php$ 块。
- 确认当前站点实际生效的配置位置：查
/usr/local/phpenv/nginx/conf/vhost/xxx.conf或类似路径下的具体server块 - 在对应
server块内添加：client_max_body_size 512M（建议比 PHP 的post_max_size多留 16–32M 余量） - 如果只针对上传接口，更稳妥的做法是加在
location ~ ^/api/upload这类精确匹配块里，避免全局放宽带来安全风险 - 改完必须执行
nginx -s reload，用curl -X POST -H "Content-Type: text/plain" --data-binary @/dev/zero -H "Content-Length: 536870912" http://yoursite.com/test测试是否还报 413
post_max_size 和 upload_max_filesize 必须同时调大且满足大小关系
PHP 在解析 POST 请求时，先检查 post_max_size，再检查 upload_max_filesize。哪怕你只传一个文件、没其他字段，只要 post_max_size 小于实际请求体（含 boundary、字段、文件二进制），PHP 就直接丢弃整个请求——$_POST 和 $_FILES 全为空，但日志里没有错误提示，非常难排查。
- 设
upload_max_filesize = 500M，则post_max_size至少设为512M（multipart 请求体实际比文件大 2–5%） - 修改
/usr/local/phpenv/php/<version>/etc/php.ini</version>，不是某个 conf.d 下的覆盖文件 - 改完必须重启
php-fpm：例如systemctl restart phpenv-php<version>-fpm</version>（注意版本号匹配） - 用
php -i | grep -E "(post_max_size|upload_max_filesize)"确认值已更新，别只信配置文件改了
max_execution_time 和 max_input_time 要区分用途并设足
大文件上传耗时主要在数据接收和磁盘写入，这两个超时参数控制不同阶段：前者管整个脚本生命周期，后者专管“从网络读取输入数据”的时间。只调大 max_execution_time 不够，max_input_time 超了也会中断连接，表现为客户端卡住、服务端无日志。
立即学习“PHP免费学习笔记（深入）”；
-
max_input_time = 600（10 分钟）：确保能收完慢网速下的完整 POST body -
max_execution_time = 600：给 ThinkPHP 的验证、移动文件、生成缩略图等后续操作留出时间 - 注意：phpEnv 中部分版本默认
max_input_time = -1（不限制），但某些编译选项会禁用该行为，务必显式设值 - 若使用分片上传，这两个值可适当降低（如 120 秒），但单次全量上传必须按总预期时长设
upload_tmp_dir 权限与磁盘性能常被忽略
PHP 把上传文件先暂存到 upload_tmp_dir，ThinkPHP 才调用 move_uploaded_file()。这个目录如果权限不对、空间不足、或在机械盘/NFS 上，会导致静默失败：错误码仍是 UPLOAD_ERR_OK (0)，但文件就是移不动。
- 检查路径是否存在：
ls -ld /var/tmp/php-upload（推荐自定义路径而非默认/tmp） - 确认 PHP-FPM worker 用户（如
www或phpenv）对该目录有读写权限：chown www:www /var/tmp/php-upload && chmod 700 /var/tmp/php-upload - 用
df -h /var/tmp看剩余空间，大文件上传期间 tmp 目录至少预留 2 倍文件大小 - 如果服务器有 SSD，把
upload_tmp_dir指向 SSD 分区（如/data/tmp/php-upload），避免磁盘 I/O 成瓶颈
真正容易卡住的地方，往往不是 upload_max_filesize 设多少，而是 client_max_body_size 写在哪、upload_tmp_dir 的 owner 是谁、以及 max_input_time 到底有没有生效——这三处不验，光调 PHP 参数等于白调。
