需依次调整PHP、Web服务器、ThinkPHP三层配置：一、修改php.ini中upload_max_filesize、post_max_size并重启PHP；二、Nginx加client_max_body_size或Apache设LimitRequestBody；三、框架层调用$file->validate()执行业务规则校验。
如果您在使用ThinkPHP上传文件时遇到“文件过大”、“Post size exceeded”或“413 Request Entity Too Large”等错误，则说明上传限制在某一层被触发。以下是解决此问题的步骤：
一、调整PHP底层配置参数
PHP解析请求前会强制校验上传体积，upload_max_filesize控制单文件上限，post_max_size控制整个POST请求体上限，二者必须协同设置，且修改后需重启PHP服务才生效。
1、打开php.ini文件，定位到upload_max_filesize指令，将其修改为所需值，例如：upload_max_filesize = 50M
2、继续查找post_max_size指令，确保其值不小于upload_max_filesize，建议留出5–10MB余量，例如：post_max_size = 60M
立即学习“PHP免费学习笔记（深入）”；
3、可选但推荐：检查max_file_uploads参数（默认20），如需单次上传更多文件，可设为更高值，例如：max_file_uploads = 50
4、保存php.ini，执行systemctl restart php-fpm（或对应版本命令）重启PHP服务
5、新建一个包含phpinfo()的PHP文件，访问该页面，确认上述三项参数已更新为新值
二、配置Web服务器请求体限制
Nginx或Apache会在请求抵达PHP之前拦截超限请求体，若未显式放宽，即使PHP配置再大也无效；该层拦截返回HTTP 413错误，且PHP日志中无记录。
1、若使用Nginx，在站点对应的server块内添加：client_max_body_size 60m;
2、避免将client_max_body_size写在http全局块中，以防影响其他虚拟主机
3、若使用Apache，在虚拟主机配置或.htaccess中添加：LimitRequestBody 62914560（单位为字节，60MB=62914560）
4、执行nginx -t && nginx -s reload验证并重载Nginx配置；Apache则执行apachectl graceful或重启服务
5、上传超大文件时，还可检查Nginx的fastcgi缓冲区配置，必要时增大fastcgi_buffer_size和fastcgi_buffers
三、设置ThinkPHP框架层验证规则
框架层校验属于应用逻辑级预检，仅在PHP成功接收文件后执行，用于细化业务规则（如单字段限制、类型组合），不替代底层配置，但必须显式调用$file->validate()才生效。
1、在控制器中获取上传文件对象：$file = $this->request->file('avatar');
2、定义验证规则数组，注意size单位为字节、ext必须全小写、不含点：$rule = ['size' => 52428800, 'ext' => ['jpg', 'png', 'pdf']];
3、显式调用validate方法：$file->validate($rule);
4、若校验失败，框架抛出think\exception\FileValidateException，需用try-catch捕获并处理其getMessage()
5、严禁将规则误写为['fileSize'=>..., 'fileExt'=>...]格式——该语法属于旧版验证器规则，不适用于think\File::validate()方法
四、修改ThinkPHP应用级上传配置
部分ThinkPHP版本（如6.x）支持在config/filesystem.php或独立config/upload.php中声明默认上传参数，供File类实例初始化时参考，但该配置不自动触发校验，仍需配合validate()调用。
1、在config/upload.php中定义数组：return ['maxSize' => 52428800, 'exts' => ['jpg','png','gif']];
2、在控制器中加载该配置：$config = config('upload');
3、构建验证规则时复用配置值：$rule = ['size' => $config['maxSize'], 'ext' => $config['exts']];
4、确保move()前已完成validate($rule)调用，否则该配置仅作参考，不产生实际限制作用
5、注意：该配置不覆盖PHP.ini或Web服务器限制，仅用于组织框架层规则逻辑
五、验证前端与后端一致性
前端HTML的<input type="file">不支持maxlength属性校验文件大小，浏览器原生无此能力；所谓“前端限制”必须通过JavaScript读取File.size实现，仅作友好提示，不可替代服务端校验。
1、在表单提交前绑定change事件，读取首个文件大小：const file = e.target.files[0]; if (file && file.size > 52428800) { alert('文件不能超过50MB'); }
2、禁止依赖<input maxlength="...">，该属性对文件输入无效，会被浏览器忽略
3、若使用AJAX上传，需在FormData.append()后、fetch()前再次校验file.size
4、前端提示文案应与后端实际限制一致，避免用户因提示“最大50MB”而上传49MB文件却因post_max_size=40M失败
5、上传超限时，服务端返回的HTTP状态码可能为413（Nginx）、400（PHP截断）或200+自定义错误码（框架校验失败），前端需分别处理
