tp6.0图片上传失败主因是前端multipart表单name未匹配后端$file()调用或upload_tmp_dir不可写：前者需确保name="images[]"且tp6.0.13+才支持$request->file('images')返回数组，低版本须循环取；后者导致$_files为空，validate()根本无法触发。
TP6.0 图片上传失败，90% 是 multipart 表单没对上，或 upload_tmp_dir 根本不可写 —— 这两个环节断了，后续所有逻辑都白跑。
前端表单 name 和后端 $request->file() 怎么匹配才有效
ThinkPHP 6.0 默认不识别 name="images[]" 这种扁平化数组名。浏览器发过来的 images[0]、images[1] 在 TP6.0（非 6.0.13+）里会被当单个字段忽略，$request->file('images') 返回 null 或单个 think\File 实例，而非数组。
实操建议：
- 前端必须用
<input type="file" name="images[]" multiple>，且确保 form 的enctype="multipart/form-data"存在 - TP6.0.12 及更早版本：不能依赖
$request->file('images')直接得数组，要手动循环获取：$request->file('images.0')、$request->file('images.1')… 或改用$_FILES['images']原生处理 - TP6.0.13+ 才真正支持
$request->file('images')返回File对象数组；升级前别硬套文档示例 - 用
var_dump($_FILES)看原始结构，比猜命名规则更可靠
upload_tmp_dir 权限不对，$file->validate() 都不会触发
PHP 在解析 multipart 请求时，第一步就是把文件写进临时目录。如果 upload_tmp_dir 为空、指向 /tmp（但属主不是 www）、或权限为 drwxr-xr-x（缺写位），整个请求体就解析失败 —— 此时 $_FILES 为空，$request->file() 必然返回空，连 validate() 都没机会调用。
实操建议：
- 执行
php -i | grep upload_tmp_dir，确认输出路径是否明确、非空、非/tmp - 若指向
/tmp，立刻建独立目录：mkdir -p /www/wwwroot/your-site.com/tmp，再chown www:www /www/wwwroot/your-site.com/tmp && chmod 700 /www/wwwroot/your-site.com/tmp - 在宝塔 PHP 设置 → 配置修改中，取消注释并填入
upload_tmp_dir = /www/wwwroot/your-site.com/tmp，保存后务必【重启 PHP】 - 别信
ls -ld /tmp显示drwxrwxrwt就安全 —— 粘滞位下，非属主用户无法在其中创建文件，www用户照样被拒
$file->move() 报 “Uploaded file is not valid”，其实校验根本没跑
这个错误不是校验失败，而是 move() 被调用了但前面没做 validate()，或者 validate() 返回 false 后仍强行 move()。TP6 中每个 File 实例的校验状态只生效一次，且 move() 内部会重命名临时文件，第二次调用直接找不到源文件。
实操建议：
- 每个文件必须单独校验：
if (!$file->validate(['size' => 5242880, 'ext' => 'jpg,png,gif'])) { echo $file->getError(); continue; } - 验证通过后再
move()，不要复用同一个$file多次调用move() -
ext规则只校验原始后缀（如evil.jpg.php会被放过），敏感场景需额外检查 MIME 或内容头 - 批量上传时，先统一
move()到临时子目录（如runtime/upload_tmp/+uniqid()），全部校验完再移到最终路径，失败时清理临时目录即可
最易被忽略的是：TP6 的 File 实例不共享状态，每个文件的 validate() 和 move() 必须成对、独立执行 —— 没有“全局开关”或“批量校验方法”，想省事反而最容易丢文件。
