ThinkPHP 6.1 文件上传“失效”主因是validate()不适用于文件验证，必须改用rule()（等价于validateRule()）挂载到think\File实例；需确保表单含enctype="multipart/form-data"、size单位为字节、ext全小写无点逗号分隔，且moveTo()前调用isValid()执行校验。
ThinkPHP 6.0 升级到 6.1 后文件上传组件“失效”，90% 不是组件坏了，而是验证逻辑、调用方式和默认行为发生了不兼容变更——最常见的是 validate() 被误用、enctype 缺失、size 单位写错，或没走 rule() 入口。
validate() 在 TP6.1 中对文件无效，必须改用 rule()
很多人把模型验证那一套直接搬过来：$file->validate(['size'=>1024])，结果完全不触发。因为 validate() 是 think\Model 方法，只校验数据库字段；而上传文件是 think\File 实例，必须用它自己的 rule()（等价于 validateRule()）。
-
$file必须是think\File对象，不是原始$_FILES['xxx']数组；可通过request()->file('name')获取 - 正确写法：
$file->rule(['size'=>1048576,'ext'=>'jpg,png,gif'])（注意单位是字节，不是 KB） - 如果仍返回
true却没拦截，检查是否漏了moveTo()前的isValid()判断——rule()只设规则，isValid()才真正执行校验
表单 enctype 和扩展名大小写是静默失败元凶
上传连 file is not upload 都不报，直接跳过验证？大概率卡在第一步：HTML 表单没声明编码类型，或者扩展名校验被服务器环境绕过。
- 确认表单含
enctype="multipart/form-data"——缺这个，$_FILES为空，request()->file()返回null，后续全失效 -
ext值必须全小写、无点、逗号分隔：'jpg,png,gif'✅，'JPG,png'❌，'.jpg'❌ - TP6.1 默认忽略大小写比对，但部分 Nginx + PHP-FPM 组合下 MIME 推断可能失败，建议强制用
getimagesize()或finfo_open()补充二进制校验
moveTo() 失败常因目录权限或路径错误，而非验证本身
验证通过了，moveTo('uploads/') 却报错“failed to open stream”，这不是上传组件问题，是运行时上下文没准备好。
立即学习“PHP免费学习笔记（深入）”；
-
moveTo()的参数是**相对 public/ 的路径**，不是绝对路径；若想存到public/uploads/，就传'uploads/'，别写../public/uploads/ - 目标目录必须存在且 Web 进程可写；TP6.1 不会自动创建子目录，需手动
mkdir($path, 0755, true) - Linux 下注意 SELinux 或 AppArmor 限制，可临时用
ls -Z uploads/检查上下文标签
升级后上传逻辑看似“失效”，本质是 TP6.1 把文件处理从模型层彻底剥离，强调类型安全与职责分离。最容易被忽略的是：你写的那行 validate() 根本没被执行，而你以为它在工作。
