不能直接存到 upload/ 目录，因单目录超10万文件会导致linux文件系统性能骤降、web服务器访问抖动；thinkphp不自动分目录，需手动按上传时间生成如2024/06/15的子路径并确保目录存在。
ThinkPHP 上传文件为什么不能直接存到 upload/ 下
直接把所有上传文件扔进 upload/ 目录，短期看着没问题，实际跑几个月就会卡顿、备份慢、检索崩溃。Linux 文件系统对单目录下超 10 万文件极其敏感，ls、find、rsync 都会明显变慢；Nginx 或 Apache 的静态文件访问也可能因目录索引耗时上升而抖动。
ThinkPHP 默认的 Upload 类或 think\File 并不自动分目录，它只负责保存到你指定的根路径，日期分目录得自己控制。
- 别依赖
rootPath写死为upload/，必须动态拼出带年月日的子路径 - 注意
moveTo()前要确保目标目录存在，否则抛think\Exception或静默失败（取决于版本） - ThinkPHP 6.0+ 的
File::moveTo()不会自动创建多级目录，得用is_dir()+mkdir()补全
如何在 saveAs() 前生成 2024/06/15 这样的路径
核心是把上传时间（不是服务器当前时间）作为路径依据，避免文件和记录时间错位。推荐用 $_FILES['file']['tmp_name'] 上传瞬间的时间戳，再格式化：
$datePath = date('Y/m/d', $_SERVER['REQUEST_TIME']); // 更稳，比 time() 少并发偏差
$savePath = 'upload/' . $datePath . '/';
// 确保目录存在
if (!is_dir($savePath)) {
mkdir($savePath, 0755, true);
}
$file->moveTo($savePath . $file->getOriginalName());
- 别用
date('Y/m/d')直接拼，万一上传跨零点，文件物理路径和数据库记录的created_at可能分属两天 - ThinkPHP 6.1+ 支持
$file->rule('date')，但只生成类似20240615123456_abc.jpg的文件名，不改路径 - 如果用模型关联上传字段，记得在
save()前手动 setsave_path字段为2024/06/15
nginx 静态访问分目录文件要注意什么
路径变成 /upload/2024/06/15/test.png 后，Nginx 默认配置通常仍能访问，但有三个隐藏雷区：
- location 匹配里如果写了
alias /var/www/html/upload;，那必须改成alias /var/www/html/;，否则 404（因为 alias 末尾斜杠行为敏感） - 开启
autoindex off;，否则用户访问/upload/2024/会列出所有月份目录 - 如果用了 CDN 或对象存储回源，确认回源 URL 路径和本地磁盘路径严格一致，比如
upload/2024/06/15/不能少一个/
迁移旧文件时怎么避免 500 错误和断链
已有几万文件在 upload/ 根目录，不能直接 mv，否则正在访问的老链接立刻 404。必须双写 + 301 兼容：
- 新上传走
upload/Y/m/d/，老文件不动，加一层 Nginx rewrite 回退：
location ^~ /upload/[^/]+\.(\w+)$ {
try_files $uri /upload/2024/01/01/$uri =404;
}
- 用脚本批量移动时，先
find upload/ -type f -name "*.jpg" | head -1000小步试跑 - 数据库里的
file_path字段不要马上更新，等前端确认新路径访问稳定后再批量 update
分目录看着只是改个路径，真正麻烦的是动静态路径一致性、迁移原子性和线上可观察性——漏掉任意一环，就有人找你修“图片突然打不开”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
