thinkphp文件上传失败主因是php底层配置未启用：file_uploads必须为on；upload_max_filesize和post_max_size需合理设置并重启服务；upload_tmp_dir权限、磁盘空间及selinux等也需检查；thinkphp中应先用geterror()获取原生错误码，再moveto。
ThinkPHP 做前后端分离的文件上传接口失败，多数不是框架写法问题，而是底层 PHP 环境或请求链路没对齐。核心得从“请求能否进得来”“PHP 能不能接得住”“框架能不能存得下”三层来看。
PHP 上传开关和大小限制没开
这是最常被忽略的第一关。前后端分离时，前端发的是 POST 请求（常带 FormData），但若 PHP 底层关了上传功能，连 $_FILES 都是空的，接口自然静默失败。
- file_uploads = On 必须开启，否则整个上传机制被禁用
- upload_max_filesize 要大于你要传的文件，比如传 10MB 视频，至少设为 12M
- post_max_size 必须 ≥ upload_max_filesize（建议大 5M 左右），否则 POST 数据体在进入 PHP 前就被截断，$_FILES 可能为空或 error=0 但 tmp_name 为空
- 改完 php.ini 后一定要重启 php-fpm 或 Apache，再用 phpinfo() 页面确认值已生效
临时目录不可用或被拦截
PHP 接收文件后，会先写入临时目录（upload_tmp_dir），再由 ThinkPHP 移走。这里卡住，接口就报错 UPLOAD_ERR_NO_TMP_DIR（error=6）或 UPLOAD_ERR_CANT_WRITE（error=7）。
- 检查 phpinfo() 中 upload_tmp_dir 的路径是否存在、是否可写（属主需为 web 进程用户，如 www-data）
- 磁盘空间是否充足，尤其 /tmp 所在分区（df -h 查看）
- Linux 服务器开了 SELinux 或 AppArmor？可用 ausearch -m avc -ts recent 查拦截日志
- open_basedir 开启时，upload_tmp_dir 路径必须加进白名单，否则 PHP 直接拒绝使用
ThinkPHP 存储路径权限或位置不合法
前后端分离中，ThinkPHP 接口通常把文件存到非 Web 可访问路径（如 runtime/upload/），但若路径不存在、无写权限，或违反框架安全策略，也会失败。
- savePath 设置的目录必须真实存在，且 web 进程用户有写权限（chown www-data:www-data + chmod 755）
- 避免直接写根目录或系统敏感路径；ThinkPHP 旧版本对 Public 目录外的路径写入有限制，新版本虽放宽，但仍建议路径明确、相对清晰
- Windows 下注意路径分隔符，用 / 或 DIRECTORY_SEPARATOR，别混用 \
- moveTo() 前务必先调 $file->getError()，它返回原生 PHP 错误码（如 'UPLOAD_ERR_NO_TMP_DIR'），比 validate() 更早暴露问题
前端请求或 Nginx/Apache 配置干扰
前后端分离常跨域，或走反向代理，中间件可能悄悄拦掉大文件。
- 表单数据必须用 FormData 提交，且请求头不能手动覆盖 Content-Type（浏览器会自动设为 multipart/form-data）
- Nginx 要配 client_max_body_size（默认 1M），需 ≥ post_max_size，否则请求还没到 PHP 就被 413 拦截
- Apache 用 LimitRequestBody 控制请求体大小，同样要放开
- CORS 配置若没允许 Content-Type 和自定义头，也可能导致预检失败，文件根本发不出
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
