ThinkPHP部署后文件上传失败的解决方法是：先在public目录下创建uploads子目录，再赋予Web服务器用户写权限（如chown -R www-data:www-data public/uploads），然后在filesystem.php中配置绝对路径的uploads磁盘，最后在控制器中校验并调用move('uploads')保存文件。
ThinkPHP部署后文件上传失败，常见原因是public目录下缺少uploads子目录，或Web服务器用户对该目录无写权限，导致move()方法静默报错“无法写入目录”。
创建并配置上传目录位置
在项目根目录的public文件夹内手动新建uploads子目录，不要放在application、config或runtime等敏感路径下。
【绝不能放在 application/ 或 config/ 等敏感目录下】
确认该目录路径为public/uploads，后续所有配置和代码都基于此相对路径展开。
立即学习“PHP免费学习笔记（深入）”；
设置Web服务器对uploads目录的写权限
先查清当前Web服务运行用户：执行ps aux | grep nginx（Nginx）或ps aux | grep apache（Apache），看主进程USER列值，常见为nginx、www-data或apache。
再用ls -ld public/uploads检查目录归属与权限，若显示drwxr-xr-x 2 root root，说明当前不属于Web用户。
执行命令赋予所有权：sudo chown -R www-data:www-data public/uploads（Ubuntu Apache/Nginx）或sudo chown -R nginx:nginx public/uploads（CentOS Nginx）。
设置最小安全权限：sudo chmod 755 public/uploads。禁止使用chmod 777——这会暴露整个目录给任意脚本执行风险。
配置filesystem.php磁盘路径
打开config/filesystem.php，在disks数组中新增一个名为uploads的本地磁盘配置：
添加以下内容（注意root必须是绝对路径）：
'uploads' => [
'type' => 'local',
'root' => app()->getRootPath() . 'public' . DS . 'uploads',
'url' => '/uploads',
'visibility' => 'public'
],
【root路径必须是绝对路径，相对路径会导致move_uploaded_file失败】
控制器中完成上传与校验
第一步：在控制器方法中获取文件对象：$file = request()->file('avatar');
第二步：执行白名单校验，size、ext、mime三者缺一不可：$file->validate(['size'=>2097152, 'ext'=>'jpg,png,gif,webp', 'mime'=>'image/jpeg,image/png,image/gif,image/webp']);
第三步：调用move()保存，传入相对路径即可：$info = $file->move('uploads');
第四步：判断结果，失败时立即输出错误：if (!$info) { dump($file->getError()); }
注意：move()第二个参数若传了完整路径（如/var/www/xxx.jpg），会跳过框架路径拼接逻辑，导致文件写入错误位置。
验证上传功能是否生效
启动开发服务器，访问含表单的页面，确保
