laravel 8 文件上传需生成唯一文件名防覆盖：基础用 time() 拼接；增强用 microtime 或 str::uuid()；生产级用 date+自增索引+安全清洗，确保多文件不冲突。
在 Laravel 8 中处理多用户或高频上传时，原始文件名（如 report.pdf、avatar.jpg）极易重复，直接使用会导致后一个文件覆盖前一个，造成数据丢失。必须在保存前生成具备时间精度与业务区分度的唯一文件名。
基础防重：用 time() + 原始文件名拼接
这一步适用于单文件上传且对命名语义要求不高的场景。
第一步：确认请求中存在上传文件，避免调用 getClientOriginalName() 时抛出 “Call to a member function on null” 错误：【$request->hasFile('photo') 必须为 true 才能继续】
第二步：获取扩展名并拼接时间戳：$extension = $request->file('photo')->getClientOriginalExtension(); $filename = time() . '_' . $request->file('photo')->getClientOriginalName();
第三步：用 Storage::putFileAs 存入 public 磁盘，自动处理路径与权限：Storage::disk('public')->putFileAs('uploads', $request->file('photo'), $filename);
增强防重：加入毫秒级时间戳与随机因子
当同一秒内上传多个同名文件（例如批量导出的 Excel），仅用 time() 仍可能冲突。需提升时间粒度并引入扰动。
方法一：用 microtime(true) 生成带毫秒的浮点数，转整型再截取后 10 位：$ms = substr((int)(microtime(true) * 10000), -10); $filename = $ms . '_' . Str::random(4) . '_' . $request->file('doc')->getClientOriginalName();
方法二：用 Laravel 内置的 Str::uuid() 替代时间戳，彻底规避时序依赖：$filename = Str::uuid() . '.' . $request->file('doc')->getClientOriginalExtension(); —— 此方式生成的字符串全球唯一，但丧失时间可读性。
生产级防重：组合时间戳 + 自增索引 + 安全清洗
适用于多文件数组上传（files[]），需确保每张图都有独立标识，且原始名称中的空格、特殊符号不破坏路径。
① 先校验并提取全部文件：$files = $request->file('files'); if (!$files || !is_array($files)) { return response('No files uploaded', 400); }
② 初始化计数器，遍历清洗每个文件名：$i = 0; foreach ($files as $file) { $cleanName = preg_replace('/[^A-Za-z0-9._\-]/', '_', $file->getClientOriginalName()); $ext = $file->getClientOriginalExtension(); $finalName = date('ymdHis') . '_' . $i . '_' . $cleanName; $i++;
③ 使用 storeAs 强制指定磁盘与子目录，避免 public_path() 硬编码风险：Storage::disk('public')->storeAs('user_uploads/' . $request->user()->id, $finalName, ['visibility' => 'public']);
④ 注意：date('ymdHis') 格式共 12 位，已覆盖年月日时分秒，足够应对单用户每秒 100+ 上传；【$i 必须在循环内递增，否则所有文件将获得相同后缀导致覆盖】
