应基于文件内容计算MD5哈希并分级存储：取md5_file()结果前两位建子目录，后30位作文件名，确保唯一性、防覆盖、防冗余；须在临时文件被移动前调用md5_file()，并提前创建目录。
ThinkPHP 上传文件名重复导致覆盖怎么办
直接用 uniqid() 或时间戳拼接，根本挡不住并发上传同名文件——两个请求几乎同时进来，生成的文件名一模一样，后传的直接覆盖前传的。真正靠谱的做法是基于文件内容算哈希，再结合目录分级存储。
为什么不能只靠 moveUploadFile() 的自动重命名
ThinkPHP 默认的 moveUploadFile()（或新版的 validate()->move()）确实会加随机后缀，但它只对「同一次请求内多个同名文件」起作用；跨请求、跨进程时，它不感知其他正在上传的文件，完全无法避免冲突。
- 默认策略不校验目标路径是否已存在同名文件
- 随机字符串长度短（如 6 位），高并发下碰撞概率不可忽略
- 不支持按内容去重，用户反复上传同一张图，仍会存多份冗余
用 md5_file() + 目录哈希分级生成唯一路径
核心逻辑：读取临时文件，计算 md5_file() 得到 32 位哈希值，取前两位做子目录，后 30 位作文件名。这样既唯一、又天然防重、还利于海量文件分散存储。
- 必须在
$_FILES临时文件未被移动前调用md5_file()，否则读不到内容 - 别用
file_get_contents()全读再md5()，大文件会爆内存；md5_file()是流式计算，安全 - 哈希前可先用
$_FILES['file']['size']快速过滤空文件，省掉无效计算 - 示例路径：
uploads/ab/abcdef01234567890123456789012345.jpg
注意 uploadMaxSize 和临时文件生命周期
如果文件超大，PHP 可能在你调用 md5_file() 前就清理了 tmp_name ——这不是 ThinkPHP 的锅，是 PHP 自身配置和 post_max_size / upload_max_filesize 限制导致的。
立即学习“PHP免费学习笔记（深入）”；
- 确保
upload_max_filesize和post_max_size设置合理，且大于预期最大上传体积 - 不要在控制器里做耗时哈希计算后才调用
move()；最好在验证通过后立刻算哈希、生成目标路径，再一次性移动 - 若用 Swoole 或常驻进程环境，
tmp_name生命周期更短，必须严格检查is_uploaded_file()再操作
哈希本身不难，难的是哈希时机卡在临时文件有效期内，以及目录结构得提前建好——漏掉 mkdir($subDir, 0755, true)，写入直接失败，错误还藏在底层，不容易一眼看出来。
