ThinkPHP上传“大小超限”主因是PHP底层限制，需同步调大php.ini中upload_max_filesize和post_max_size（后者≥前者），并重启PHP服务；Nginx用户还需配置client_max_body_size；ThinkPHP的size验证仅为应用层校验，单位为字节。
ThinkPHP 上传文件提示“大小超限”，通常不是框架本身限制，而是受 PHP 底层配置影响。需从 PHP 配置和 ThinkPHP 层面两处排查修改。
修改 PHP 的上传限制（关键步骤）
PHP 默认对上传文件有严格限制，必须先调高这些值：
-
upload_max_filesize：单个文件最大允许大小 -
post_max_size：整个 POST 请求体最大大小（需 ≥upload_max_filesize） -
max_execution_time和max_input_time（可选）：大文件上传可能超时，建议适当增加
操作方式：
编辑你的 php.ini 文件，找到并修改以下项（例如设为 50M）：
upload_max_filesize = 50M post_max_size = 50M max_execution_time = 300 max_input_time = 300
修改后务必重启 Web 服务器（如 Apache 或 Nginx + PHP-FPM），否则不生效。
✅ 小提示：可通过
phpinfo()或echo ini_get('upload_max_filesize');确认当前值是否已更新。立即学习“PHP免费学习笔记（深入）”；
ThinkPHP 自身的上传配置（补充控制）
ThinkPHP 6.x 在调用 ->validate(['size' => 1024 * 1024 * 50]) 或使用 FileValidate 时，会校验文件大小，但这个是应用层校验，不影响底层上传失败。若你看到的是 ThinkPHP 抛出的「上传文件超过允许大小」异常，检查控制器中是否手动设置了 size 限制：
$request->file('image')->validate(['size' => 52428800])->move($path);可调整 size 值（单位：字节），或移除该验证项让其仅依赖 PHP 层限制。
Nginx 用户额外注意
如果你用 Nginx，它也有 client_max_body_size 限制，默认通常是 1M：
server {
client_max_body_size 50M;
# 其他配置...
}修改后执行 nginx -t && nginx -s reload 生效。
检查上传失败的真实原因
上传失败时，不要只看报错文字。建议在控制器中打印原始错误：
$file = $request->file('xxx');
if ($file && $file->getError()) {
dump($file->getError()); // 查看是 PHP 错误码还是 ThinkPHP 验证失败
}常见错误码含义：
-
1：upload_max_filesize超限（PHP 层） -
2：MAX_FILE_SIZE表单隐藏字段超限（前端<input type="hidden" name="MAX_FILE_SIZE">） -
6：找不到临时上传目录（upload_tmp_dir配置问题）
不复杂但容易忽略
