文件上传失败需同步调整php、web服务器及框架层配置：一、调大php.ini中upload_max_filesize和post_max_size并重启php；二、nginx添加client_max_body_size；三、apache设置limitrequestbody；四、thinkphp验证规则用字节值；五、旧版tp3需设uploadfile类maxsize。
如果您在ThinkPHP项目中遇到文件上传失败、提示“Post size exceeded”或直接返回413错误，则问题通常不在框架本身，而是底层PHP与Web服务器对请求体大小的限制未同步放开。以下是解决此问题的步骤：
一、调整PHP核心上传参数
PHP在解析HTTP请求前会强制校验两个关键配置：upload_max_filesize控制单文件上限，post_max_size控制整个POST请求体（含所有字段+文件）总大小。二者必须同时调大，且post_max_size必须大于等于upload_max_filesize，否则即使只传一个文件也会被截断。
1、定位并编辑php.ini文件，查找以下两行配置项。
2、将upload_max_filesize设为预期最大单文件大小，例如：upload_max_filesize = 20M。
3、将post_max_size设为略大值以容纳表单其他字段，例如：post_max_size = 25M。
4、保存后执行systemctl restart php-fpm（或对应版本命令），确保服务完全重启。
5、访问phpinfo()页面，确认两项数值已更新生效，不可仅依赖配置文件修改。
二、配置Nginx请求体限制
Nginx在将请求转发给PHP前，独立执行client_max_body_size检查。默认值仅为1MB，若未显式配置，超限请求将直接返回413错误，PHP层根本无法介入处理。
1、进入Nginx站点配置文件，定位到对应server块或location块内。
2、添加指令：client_max_body_size 25M;。
3、禁止将其写入http全局块，以免影响其他站点。
4、执行nginx -t验证语法，再运行nginx -s reload重载配置。
5、若使用反向代理或云负载均衡（如ALB/SLB），需同步检查上游网关是否设置body size限制。
三、配置Apache请求体限制
Apache通过LimitRequestBody指令控制请求体大小，默认不限制；但若虚拟主机或.htaccess中曾设置该值（如防DOS攻击），则可能意外拦截上传请求，其作用机制与Nginx的client_max_body_size完全一致。
1、打开Apache虚拟主机配置文件或项目根目录下的.htaccess。
2、查找LimitRequestBody指令，确认其值是否小于预期上传大小。
3、若存在且过小，修改为：LimitRequestBody 26214400（即25MB，单位为字节）。
4、若无该指令，可手动添加于
5、重启Apache服务：systemctl restart apache2或httpd。
四、设置ThinkPHP框架层校验规则
框架层验证仅在PHP成功接收并生成$_FILES后才触发，属于二次校验，不能替代底层配置。其fileSize规则要求传入整数字节值，字符串单位（如'2M'）将静默失效。
1、在控制器中定义验证规则数组，例如：$rule = ['file' => 'fileSize:2097152|fileExt:jpg,png,pdf'];
2、确保该规则应用于think\Validate实例或直接传入File对象的validate()方法。
3、注意size单位为字节，2097152 = 2 × 1024 × 1024，不可写作'fileSize'=>'2M'。
4、若需区分多字段限制（如头像≤2MB、附件≤20MB），须为每个字段单独声明fileSize规则。
5、空文件（size=0）默认通过fileSize校验，如需禁止，额外添加require规则。
五、修改ThinkPHP旧版Upload类参数
针对ThinkPHP 3.x等旧版本，其ORG/Net/UploadFile类提供maxSize属性直接控制单文件上限，该值仅在框架接收文件后生效，仍需前置PHP与Web服务器配置支撑。
1、在上传逻辑中实例化UploadFile对象：$upload = new UploadFile();
2、设置maxSize属性为字节数，例如：$upload->maxSize = 2097152;。
3、同时设置allowExts指定允许扩展名，savePath指定存储路径。
4、调用$upload->upload()执行上传，失败时通过$upload->getErrorMsg()获取提示。
5、该方式不适用于ThinkPHP 6+，新版应统一使用validate()配合File对象。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
