ThinkPHP6文件上传路径错误本质是文件未存至预期位置，主因包括：一、目标目录不存在或不可写，需手动创建并赋权；二、混淆保存路径与可访问URL，应使用绝对路径保存、相对路径生成URL；三、Filesystem驱动配置错误，如root路径解析偏差或远程驱动误用moveTo()；四、PHP临时目录失效，需检查upload_tmp_dir及open_basedir配置。
ThinkPHP6 文件上传路径错误，本质不是“路径写错了”，而是文件根本没存到你认为的位置。常见表现是：调用 $file->move('uploads') 后找不到文件、返回的 $info->getSaveName() 是奇怪临时路径（如 phpABC123.tmp），或前端访问链接 404。核心问题集中在目标目录、权限、路径类型和驱动配置四个层面。
一、目标目录不存在或不可写
ThinkPHP 不会自动创建多级目录。哪怕你写 $file->move('uploads/avatar')，也要求 public/uploads/avatar/ 这个完整路径已存在，且 Web 进程用户（如 www-data 或 nginx）有写权限。
- 手动创建目录：
mkdir -p public/uploads - 设置权限：
chown -R www-data:www-data public/uploads && chmod -R 755 public/uploads - 确认路径正确：使用绝对路径，例如
ROOT_PATH . 'public' . DS . 'uploads'，避免相对路径歧义 - 上传后检查返回值：
if (!$info) { dump($file->getError()); }，错误信息直接指向目录或权限问题
二、混淆了“保存路径”和“可访问 URL”
move() 只负责把文件写入服务器磁盘，不生成网页能打开的链接。如果你存到了 public/uploads/abc.jpg，那它的可访问地址就是 /uploads/abc.jpg，而不是 $info->getPathname()（那是服务器绝对路径，如 /var/www/project/public/uploads/abc.jpg）。
- 保存时用绝对路径确保落点明确：
$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); - 构造前端 URL 用相对路径：
$url = '/uploads/' . $info->getSaveName(); - 别依赖
$info->getPathname()返回值做前端展示，它对浏览器无效
三、Filesystem 驱动配置未生效或配错
如果用了 Filesystem::disk('uploads')->putFile()，路径由 config/filesystem.php 中的 root 决定。这里最容易踩坑的是路径写法：
立即学习“PHP免费学习笔记（深入）”；
-
'root' => 'public/uploads'是相对路径，实际解析为public_path('uploads')，不是ROOT_PATH . 'public/uploads' - 务必确认该配置项下
public/uploads目录真实存在且可写 -
'url' => '/uploads'仅用于生成访问链接，不影响保存位置；但它若配错（比如写成/static/uploads），前端拿到的就是 404 地址 - 远程驱动（如 OSS、七牛）不能用
moveTo()，必须用store()方法
四、上传前就被 PHP 拦截——临时目录失效
如果 $_FILES 为空或 $file 是 null，$file->getError() 显示 UPLOAD_ERR_NO_TMP_DIR（错误码 6），说明问题出在 PHP 层，和 ThinkPHP 无关。
- 检查
php.ini中upload_tmp_dir是否设置，路径是否存在、是否可写 - 若启用了
open_basedir，必须把upload_tmp_dir路径加进白名单，例如：open_basedir = "/var/www/:/tmp/" - 重启 PHP-FPM 或 Apache 生效，仅 reload 不够
- 表单必须带
enctype="multipart/form-data"，否则$_FILES必然为空
