现象:小文件能传,大文件直接失败
后台上传几十兆的视频或压缩包,页面提示 POST Content-Length of 33554432 bytes exceeds the limit of 8388608 bytes,表单里的其他字段也一起丢失。传几百 KB 的图片却完全正常。
原因:三道限制,任何一道都会截断请求
- PHP 的 post_max_size 限制整个 POST 包体,超过后
$_POST和$_FILES会直接为空; - PHP 的 upload_max_filesize 只管单个文件,通常比 post_max_size 小;
- Nginx 的 CLIent_max_body_size 默认只有 1M,超了直接回 413,请求根本进不到 PHP。
解决步骤
第一步,把 PHP 两个值一起调大,post_max_size 必须大于 upload_max_filesize:
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
第二步,同步 Nginx 限制,放在 server 或 location 块里:
client_max_body_size 64m;
第三步,重启生效。只 reload Nginx 不够,PHP-FPM 也需要重载才能读到新 ini:
php -i | grep -E "post_max_size|upload_max"
systemctl reload php-fpm nginx
第四步,确认改的是正在用的 ini。CLI 和 FPM 的配置文件常常不是同一个,用 php --ini 看命令行,用页面里的 phpinfo() 看 FPM 实际加载路径,改错文件重启也没用。
如果用的是宝塔或容器,面板里还有一层上传限制,改完配置记得在面板设置里同步。
另外一个容易踩的坑:post_max_size 触发时,PHP 不会抛异常,只是把 $_POST 和 $_FILES 清空。如果业务代码里有 CSRF 校验,你会看到"令牌无效"这种看似无关的报错,而不是上传失败。排查时先看 Nginx 的 error.log 有没有 413,再看 PHP 的 error_log 里有没有 Content-Length 的 warning,两条日志就能定位是哪一层截断的。
小结
先看报错类型:出现 413 是 Nginx 拦的,出现 Content-Length 提示是 PHP 拦的。两层都改到位,再确认配置文件路径正确。
