ThinkPHP上传大文件报Post size exceeded的Nginx与PHP配置调整-ThinkPHP-PHP中文网

PHP上传大文件需同步调大post_max_size和upload_max_filesize，且Nginx的client_max_body_size必须同步配置，否则请求在到达PHP前就被拦截；超时设置（fastcgi_read_timeout、max_execution_time等）也需延长。

thinkphp上传大文件报post size exceeded的nginx与php配置调整

PHP 的 `post_max_size` 和 `upload_max_filesize` 必须同时调大

ThinkPHP 上传大文件失败，报 Post size exceeded，本质是 PHP 拦截了超限的 POST 数据，不是框架问题。关键在两个 ini 配置：前者限制整个 POST 请求体大小（含所有字段+文件），后者只管单个上传文件。很多人只改了 upload_max_filesize，忘了 post_max_size 必须 ≥ 它，否则文件还没进到上传逻辑就被 PHP 直接拒掉。

实操建议：

post_max_size 建议设为略大于最大预期上传总大小（比如多文件 + 表单字段合计 100MB，则设 128M）
upload_max_filesize 设为单文件上限（如 64M）
修改后必须重启 PHP-FPM（systemctl restart php-fpm 或对应版本命令），仅 reload 不生效
用 phpinfo() 页面确认值已更新，别只信配置文件写对了

Nginx 的 `client_max_body_size` 是第一道关卡

即使 PHP 配置全放开，Nginx 默认只允许 1MB 的请求体，超了直接返回 413 Request Entity Too Large，根本不会把请求转给 PHP。这个配置必须显式增大，且要放在 server 或 location 块里，不能只写在 http 块（除非你确定所有接口都需大上传）。

常见错误现象：

浏览器控制台看到 413 错误，但 PHP 错误日志空空如也 → 八成是 Nginx 拦截了
ThinkPHP 日志里没记录上传动作，$_FILES 为空 → 请求压根没到 PHP 层

实操建议：

在对应站点的 server 块中加：client_max_body_size 128m;
如果用了反向代理或负载均衡，检查上游网关（如 ALB、SLB）是否也有 body size 限制
改完必须 nginx -t && nginx -s reload，语法错会导致 reload 失败但不报错

ThinkPHP 自身的上传验证只是“锦上添花”，不是“救命稻草”

框架层的 validate(['size' => 1024 * 1024 * 64]) 或 maxSize 参数，只在 PHP 成功接收并解析上传后才执行。它拦不住 Post size exceeded 这类底层拦截，更无法绕过 Nginx 413。所以别指望靠改框架配置解决这个问题。

使用场景提醒：

适合做二次校验（比如用户传了 10 个 50MB 文件，PHP 接收成功，但业务只要单个 ≤ 64MB）
配合 ext 验证能防恶意扩展名，但和大小限制无关
若开启 think\facade\Filesystem 的分片上传，需额外处理断点续传逻辑，此时 Nginx 和 PHP 的超时设置（fastcgi_read_timeout、max_execution_time）也得同步调大