ThinkPHP多文件上传只存1个是因saveName默认uniqid('', '')导致同毫秒重名覆盖，须设$upload->saveName = array('uniqid', array('', true))；同时确保public/uploads目录存在、755权限，并用ROOT_PATH+DS拼接绝对路径或filesystem磁盘管理。
ThinkPHP项目上线后上传多个文件却只存下1个，本地测试正常但服务器上反复丢失文件，这种问题往往不是代码写错，而是工作目录设置不当导致文件名冲突或路径覆盖。
确认上传类默认saveName行为
打开ThinkPHP 3.2.3源码中的ThinkPHP\Library\Think\Upload.class.php，定位到getName()方法。该方法会根据$this->saveName配置生成文件名，默认值为array('uniqid', '')——注意第二个参数为空字符串，这会导致多次调用uniqid()时在毫秒级内返回相同前缀，多文件上传时极易重名覆盖。
必须修改saveName配置，否则无论路径怎么设，文件都会被后传的覆盖掉。
修复多文件上传丢失的核心操作
在控制器中实例化Upload对象后，立即重置saveName属性：
立即学习“PHP免费学习笔记（深入）”；
$upload = new \Think\Upload();
$upload->saveName = array('uniqid', array('', true));
这个true参数会让uniqid()启用更严格的唯一性生成逻辑（基于微秒+进程ID），彻底杜绝同批次上传文件名重复。不加这句，所有补救路径设置都是徒劳。
设置上传根目录并确保可写
第一步：确认public目录下已存在uploads子目录。
第二步：给该目录设置755权限：chmod -R 755 public/uploads。权限不足时move()会静默失败，【不要设成777】。
第三步：在控制器中调用move()时传入绝对路径：$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
ROOT_PATH是框架常量，指向项目根目录；DS是目录分隔符，自动适配Windows/Linux。硬编码相对路径如./uploads在CLI或某些部署环境下会失效。
用filesystem磁盘统一管理上传路径
方法一：编辑config/filesystem.php，在disks数组中添加：
'uploads' => [
'type' => 'local',
'root' => app()->getRootPath() . 'public/uploads',
'url' => '/uploads',
'visibility' => 'public'
],
方法二：控制器中调用：Filesystem::disk('uploads')->putFile('images', $file);
注意：public/uploads目录必须手动创建且可写，【putFile不会自动创建public父目录】，只创建其下的子路径。
动态生成带日期和用户ID的子路径
第一步：编写路径生成函数（可放在common/function.php）：
function generateUploadPath($file, $prefix = '') {
$date = date('Y/m/d');
$userId = request()->user->id ?? 'guest';
return trim($prefix . '/' . $userId . '/' . $date, '/');
}
第二步：在上传逻辑中调用：
$path = generateUploadPath($file, 'avatars');
$result = Filesystem::disk('public')->putFile($path, $file);
生成的路径形如avatars/123/2026/06/04/xxx.jpg，自动按日隔离，避免单目录海量文件。但注意：public目录本身必须存在且可写，否则整个链路中断。
