File upload error 根源在PHP底层临时目录权限或配置不匹配：需检查upload_tmp_dir路径及写权限、post_max_size/upload_max_filesize/ThinkPHP maxSize三者是否协调，并确认Nginx client_max_body_size设置正确。
ThinkPHP上传报 File upload error 先看 upload_tmp_dir 和临时目录权限
这个错误表面是文件上传失败，但 ThinkPHP 本身不直接抛这个字符串——它来自 PHP 底层的 $_FILES 机制。真正触发点往往是 PHP 无法把上传文件写入临时目录。
常见现象：表单提交后返回空数组或 ['error' => 1]（UPLOAD_ERR_OK 以外的值），日志里没明显报错，phpinfo() 显示 upload_tmp_dir 是空或指向一个不可写的路径。
- 用
echo ini_get('upload_tmp_dir');确认当前生效值；为空则走系统默认（Linux 通常是/tmp，Windows 是C:\Windows\Temp） - 检查该目录是否存在、是否可写：
ls -ld /tmp或stat /tmp，确认 web 服务器用户（如www-data、nginx、apache）有写权限 - 别只改目录权限，还要确认 SELinux（CentOS/RHEL）或 AppArmor（Ubuntu）没拦截——
ausearch -m avc -ts recent | grep httpd可查拒绝记录
move_uploaded_file() 失败时 ThinkPHP 不会自动报具体原因
ThinkPHP 的 $request->file() 或 $file->move() 最终调用的是 PHP 原生 move_uploaded_file()。一旦失败，它只返回 false，而 ThinkPHP 默认不透出底层错误码（比如 UPLOAD_ERR_NO_TMP_DIR 或 UPLOAD_ERR_CANT_WRITE）。
所以你看到的 File upload error 往往是业务层兜底提示，不是原始错误。
立即学习“PHP免费学习笔记（深入）”；
- 在调用
$file->move()前，先手动检查$_FILES['xxx']['error']值：var_dump($_FILES['avatar']['error']);—— 对照 PHP 文档里的常量判断真因 - 确保目标目录存在且可写，ThinkPHP 不会自动创建多级目录；
$file->move('uploads', '', true)的第三个参数true是允许覆盖，不是自动建目录 - 注意 Windows 下路径分隔符问题：用
DS常量或str_replace('/', DS, $path)，别硬写'uploads\avatar'
ThinkPHP 配置项 upload.maxSize 和 PHP post_max_size 的关系
ThinkPHP 的 upload.maxSize 只控制框架层校验，它拦不住超限请求到达 PHP。真正卡住上传的是 PHP 的 post_max_size 和 upload_max_filesize。两者都小于等于实际文件大小时，$_FILES 就会整体为空或报错 UPLOAD_ERR_INVALID_FILE。
- 必须同时检查三个值：
ini_get('post_max_size')、ini_get('upload_max_filesize')、ThinkPHP 配置里的maxSize（单位是字节，注意别混淆 KB/MB） - 修改 php.ini 后，Apache 要
sudo systemctl reload apache2，PHP-FPM 要sudo systemctl reload php*-fpm，单纯重启 Nginx 不生效 - 如果用 Swoole 或 RoadRunner 运行 ThinkPHP，PHP 配置由 Swoole 进程加载，和 CLI 或 FPM 的 php.ini 可能不同，得单独确认
Nginx 下上传大文件要额外配 client_max_body_size
即使 PHP 层全放开，Nginx 默认只允许 1MB 请求体。超过就直接 413 Request Entity Too Large，连 PHP 都收不到请求，$_FILES 自然为空，ThinkPHP 拿不到任何文件信息。
- 在 server 或 location 块里加：
client_max_body_size 20M;（数值按需调整） - 别只改
http块——如果 ThinkPHP 是通过反向代理或子路径访问（如/api/upload），必须确保对应 location 块也包含该配置 - 改完 Nginx 配置后，用
nginx -t校验语法，再systemctl reload nginx；不 reload，配置不会生效
真正卡住上传的往往不是 ThinkPHP 代码，而是 PHP 的临时目录权限、Nginx 的 body 限制、或者三处大小配置没对齐。查的时候别一头扎进控制器逻辑，先从 $_FILES['xxx']['error'] 和 phpinfo() 开始，比翻文档快得多。
