应优先调用$file->geterror()获取php原生上传错误码字符串，如"upload_err_no_tmp_dir"，再检查$_files'field'数值，最后执行validaterule()和moveto()。
直接看 $file->getError()，别绕开它
ThinkPHP 封装了 $_FILES，但底层错误码没丢——$file->getError() 返回的就是 PHP 原生的 UPLOAD_ERR_* 常量字符串，不是布尔值或框架自定义消息。跳过这步直接调 moveTo() 或写 try-catch，等于蒙眼排障。
常见返回值含义：
-
UPLOAD_ERR_OK：上传成功，可继续 -
UPLOAD_ERR_NO_FILE：表单没传文件，可能是enctype="multipart/form-data"缺失，或前端 JS 阻止了提交 -
UPLOAD_ERR_NO_TMP_DIR：PHP 找不到可用临时目录，upload_tmp_dir为空、路径不存在、权限不足或被open_basedir拦截 -
UPLOAD_ERR_CANT_WRITE：临时文件写入成功，但 move_uploaded_file() 失败，大概率是目标目录不可写或跨文件系统 -
UPLOAD_ERR_INI_SIZE或UPLOAD_ERR_FORM_SIZE：PHP 或 HTML 表单限制了大小，和 ThinkPHP 的size规则无关
$_FILES 里 error 字段比 $file->getError() 更早暴露问题
在实例化 think\File 前，先 var_dump($_FILES['your_field_name'])。如果 error 是 0 以外的数字，说明失败发生在 PHP 接收阶段，ThinkPHP 根本没机会介入。
典型场景：
-
error === 4：表单字段为空，不是文件太大——检查是否漏了name属性或 JS 清空了 input -
error === 6：直指upload_tmp_dir失效，和框架配置无关，必须查 php.ini 和权限 -
error === 0但tmp_name为空：可能被安全模块（如 SELinux）拦截，或磁盘满、inode 耗尽
别让 validateRule() 掩盖真实错误
$file->validateRule(['size'=>2097152,'ext'=>'jpg,png']) 返回 false，不代表就是超限或格式错——它只在校验环节起作用。如果 $file->getError() !== 'UPLOAD_ERR_OK'，validateRule 根本不会执行，但你可能误以为是规则写错了。
正确顺序：
- 先检查
$file->getError() - 再确认
$file->isValid()（内部已包含 error 判断） - 最后调
validateRule()做业务层过滤 - moveTo 前务必确保目标目录存在且可写：
is_dir($path) && is_writable($path)
日志里看不到错误？关掉 display_errors 试试
很多线上环境设了 display_errors = Off，导致 move_uploaded_file() 失败时只返回 false，无任何提示。这时 $file->getError() 仍是唯一可靠入口。
临时调试建议：
- 在控制器开头加
ini_set('display_errors', '1'); error_reporting(E_ALL); - 查看 PHP 错误日志路径：
ini_get('error_log')，别只盯 ThinkPHP 日志 - 如果用 Nginx，413 错误压根不会进 PHP，
$file都不会创建——先看 Nginx access.log 和 error.log
最易忽略的点：错误码是 PHP 底层返回的整数，但 $file->getError() 返回的是对应常量名字符串，不是数字。打印出来是 "UPLOAD_ERR_NO_TMP_DIR" 这种，不是 6。别拿数字去 if 判断，要用字符串匹配或查 PHP 官方文档对照表。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
