ThinkPHP上传失败多数因环境配置或权限问题：先确认file_uploads=On、upload_max_filesize与post_max_size合理设置并重启服务；再检查目标目录是否存在且Web进程用户可写；最后排查Nginx/Apache的client_max_body_size等拦截限制。
ThinkPHP部署后上传失败，多数情况不是代码问题，而是环境配置或目录权限没到位。重点盯住三块：PHP底层上传开关是否打开、目标目录是否可写、Web服务器是否拦掉了大请求。
检查PHP上传基础配置是否启用
先确认 PHP 是否允许上传文件，这是最常被忽略的第一步：
- 确保 file_uploads = On，否则整个上传功能被禁用
- upload_max_filesize 要大于你实际要传的文件（如设为 50M）
- post_max_size 必须 ≥ upload_max_filesize，建议多留 5–10M 余量（如 55M）
- 改完 php.ini 后必须重启 php-fpm 或 Apache/Nginx，再访问
phpinfo()页面确认数值已生效
验证目标目录是否存在且可写
ThinkPHP 不会自动创建多级上传目录，moveTo() 失败往往卡在这里：
- 手动创建目标目录，例如
runtime/upload或你配置的public/uploads - 给 Web 进程用户赋权：Linux 下执行
chown -R www-data:www-data runtime/upload（Ubuntu/Apache）或chown -R nginx:nginx runtime/upload（CentOS/Nginx） - 权限设为
755（目录）和644（文件），避免长期使用777 - 若用
store()方法，还要检查config/filesystem.php中对应 disk 的root路径是否真实存在且可写
排查Web服务器拦截大请求
即使 PHP 放开了，Nginx 或 Apache 可能已在入口就拒绝了请求：
立即学习“PHP免费学习笔记（深入）”；
- Nginx 需在站点
server块中添加：client_max_body_size 100M;（不能只写在 http 全局块） - Apache 对应设置
LimitRequestBody 104857600（即 100MB） - 如果用了 CDN、WAF 或反向代理，它们也常自带 body size 限制，需同步调大
- 上传卡顿或超时？检查
client_body_timeout 300（Nginx 接收阶段）和fastcgi_read_timeout 300（PHP 处理阶段）
快速定位是框架层还是PHP底层问题
别急着改 ThinkPHP 代码，先看原始数据是否进来：
- 在控制器开头加
var_dump($_FILES); die;，如果输出为空数组，说明请求根本没把文件送进来，问题在表单、JS 构造或服务器拦截 - 表单必须含
enctype="multipart/form-data"；JS 用 FormData 时 key 名要和后端接收名一致 - 若
$_FILES有内容但$file->getError()返回非 0，比如UPLOAD_ERR_CANT_WRITE，说明临时目录或目标目录写入失败 - 打印
$file->getInfo()查看tmp_name和error字段，比直接调moveTo()更早发现问题
