必须生成唯一且业务可读的文件名以避免覆盖和冲突：基础方案用时间戳+8位随机字符串；业务关联场景嵌入清洗后的字段或模型属性；MediaLibrary需自定义FileNamer并调用uniqid('', true)；多文件上传时可用索引递增或MD5内容指纹防重。
用户上传文件时，原始文件名重复会导致覆盖旧文件、数据丢失或程序异常，必须在保存前生成具备唯一性且业务可读的文件名，同时确保高并发下不冲突。
基础时间戳+随机字符串命名
这一步操作起来很简单，直接用 Laravel 内置的 Str::random() 和 time() 拼接即可，适合中小流量项目。
第一步：在控制器中获取上传文件对象 → 调用 $file->getClientOriginalExtension() 提取扩展名 → 使用 Str::random(8) 生成 8 位随机字符串 → 拼接为 time() . '_' . Str::random(8) . '.' . $extension。
注意：【不要只用 time()】，同一秒内多次上传会生成相同时间戳，导致冲突；Str::random(8) 可大幅降低碰撞概率，但非绝对唯一。
结合业务字段的定制化命名
当文件需与具体业务实体强关联（如用户身份证扫描件、订单附件），应将关键字段嵌入文件名，提升可追溯性。
方法一：使用表单输入清洗后拼接
先调用 $request->input('user_name', 'unknown') 获取姓名 → 用 Str::slug($name, '_') 替换空格和特殊字符 → 同样处理编号字段（如 $request->input('order_no')）→ 组合为 $slugName . '_' . $cleanOrderNo . '_' . now()->timestamp . '.' . $extension。
方法二：从模型实例动态提取
若上传发生在模型创建后（如 $post = Post::create(...)），可直接用 $post->id 或 $post->slug → 拼接格式示例："post_{$post->id}_{$post->slug}_".now()->format('ymdHis').".{$extension}"。
⚠️ 提醒：所有用户输入字段必须清洗，否则可能引入路径遍历字符（如 ../）或非法文件名，造成安全风险。
MediaLibrary 中接管文件命名逻辑
Laravel MediaLibrary 默认使用 DefaultFileNamer，但无法满足业务唯一性要求，需替换为自定义策略。
① 在 app/Support/FileNamer/CustomFileNamer.php 创建类，继承 FileNamer 抽象类 → 重写 originalFileName() 方法。
② 在该方法中，先调用 pathinfo($fileName, PATHINFO_FILENAME) 获取基础名 → 追加 uniqid('', true)（带进程 ID 的微秒级唯一 ID）→ 返回 $baseName . '_' . uniqid('', true)。
③ 在模型中注册该命名器：public function registerMediaConversions(Media $media = null): void { $this->addMediaCollection('images')->useFileNamer(new CustomFileNamer()); }。
【必须调用 uniqid('', true)】，普通 uniqid() 不带第二个参数时仅基于微秒，高并发下仍可能重复；加 true 后引入进程 ID 和随机字节，彻底规避冲突。
多文件上传时防同名覆盖的递增策略
用户一次选择多个同名文件（如 5 张都叫 “receipt.jpg”），默认行为会全部覆盖成一个，必须逐个赋予不同后缀。
方法一：循环中使用索引计数
遍历 $request->file('documents') 数组 → 初始化 $counter = 0 → 每次拼接时加入 _{$counter} → 执行 $counter++。
方法二：用 md5_file() 生成内容指纹
对每个上传文件调用 md5_file($file->getRealPath()) → 截取前 6 位作为标识 → 命名为 "{$baseName}_{$md5Short}.{$extension}" → 相同内容文件名一致，不同内容绝不重复。
这一步不需要额外存储映射关系，文件系统本身已通过名称隔离了所有上传项。
