应生成唯一文件名后直接写入，避免覆盖；需用setSaveName()显式设置含扩展名的完整新名，统一小写扩展名，组合md5+时间+随机数确保唯一性，禁用uniqid()和先检查再写入的竞态逻辑。
上传时文件名重复导致覆盖怎么办
ThinkPHP 默认的 moveTo() 不会自动处理同名文件，直接覆盖是默认行为。这不是 Bug，是设计选择——框架把命名权交给你，但很多人没接住。
- 别依赖
request()->file('xxx')->move()的默认路径拼接，它只按时间戳+随机数生成目录，文件名仍用原始名 - 必须显式调用
setSaveName()或在move()时传第二个参数指定新文件名 - 如果没做重命名，又用了固定保存路径（比如
public/uploads/），同一名称的文件反复上传就会静默覆盖
用 setSaveName() 自定义文件名的坑
setSaveName() 看似简单，但容易误用：它接收的是「完整文件名」（含扩展名），不是仅改名字部分；而且必须在 move() 前调用，否则无效。
- 错误写法：
$file->setSaveName('avatar.jpg')->move('uploads')—— 如果原始文件是1.png，结果会变成avatar.jpg.png（ThinkPHP 自动补扩展名） - 正确写法：
$file->setSaveName(['md5', $file->getInfo('name')])->move('uploads')，或更稳妥地：$file->setSaveName($newName . '.' . $file->getExtension())->move('uploads') - 注意
getExtension()返回的是小写扩展名，但原始文件可能是.JPG，需统一处理避免大小写冲突
生成不重复文件名的实用组合策略
单纯用时间戳或 rand() 仍有极小概率撞车，生产环境建议组合使用哈希 + 时间 + 随机因子，同时控制长度和字符集。
- 推荐生成方式：
substr(md5(microtime(true) . $file->getInfo('name') . mt_rand(100,999)), 0, 16) . '.' . strtolower($file->getExtension()) - 避免用
uniqid()—— 它只依赖微秒时间，高并发下易重复；md5_file()又太重，不适合大文件上传前计算 - 如果业务要求保留原始文件名语义（如“张三_合同_v2.pdf”），可将原名 base64 编码后截断 + 时间戳，再加校验位，例如：
substr(base64_encode($file->getInfo('name')), 0, 12) . '_' . date('ymdHis') . '_' . substr(md5(uniqid()), 0, 6)
上传前检查文件是否已存在要慎用
先 is_file() 再决定是否重命名，看似稳妥，但在并发场景下仍是竞态条件：两次请求几乎同时判断“不存在”，然后都写入同一文件名。
立即学习“PHP免费学习笔记（深入）”；
- 不要写
if (!is_file($path)) { $file->move($path); }这类逻辑 - 真正安全的做法只有一种：生成唯一文件名后直接写入，靠文件系统原子性保证不覆盖；必要时上传成功后再建数据库记录映射原始名
- 如果真要防重复内容（而非仅防同名），得在上传后计算
md5_file()并查库，但这属于业务层去重，不是文件系统防覆盖
文件名重命名看着是小问题，但一旦漏掉扩展名处理、大小写归一、并发安全这几处，上线后就可能丢数据或混文件。最稳的方式不是“检查再写”，而是“生成唯一名后直接写”。
