ThinkPHP换域名后上传路径错乱，因$_SERVER['DOCUMENT_ROOT']与实际项目根目录不一致，应改用public_path('uploads')等可靠路径构造方式，并避免混用storage_path()与public_path()。
上传文件路径为什么在换域名后变乱了
ThinkPHP 默认用 $_SERVER['DOCUMENT_ROOT'] 拼接上传保存路径，但自定义域名映射（比如 Nginx 里用 root 指向非默认站点目录）会导致 DOCUMENT_ROOT 和实际项目根目录不一致。结果就是 think\facade\Filesystem::put() 或 move_uploaded_file() 写到错地方，甚至权限失败。
常见错误现象：file_put_contents(): failed to open stream: No such file or directory，或文件明明上传成功却找不到——其实存到了 Nginx 的 root 目录下，而非 ThinkPHP 项目里的 public/uploads。
- 确认当前
DOCUMENT_ROOT值：在控制器里临时加var_dump($_SERVER['DOCUMENT_ROOT']);，对比你期望的项目根目录（如/var/www/myapp）是否一致 - ThinkPHP 6+ 推荐统一用
app()->getRuntimePath()或public_path('uploads')构建路径，而不是拼接$_SERVER - 如果用了自定义存储驱动（如本地 disk），检查
config/filesystems.php中'root'配置项是否写死绝对路径；应改用public_path('uploads')或runtime_path('uploads')
自定义域名映射下 public_path() 返回路径不准
public_path() 底层依赖 App::getRootPath() 和 DS . 'public'，而 getRootPath() 默认从 __DIR__ 反推，一般没问题。但如果你把入口文件 public/index.php 移动过、或用软链接部署、或 Nginx 的 alias 指令替代 root，就可能让 public_path() 返回的物理路径和 Web 可访问路径错位。
典型表现：图片 URL 能访问（https://xxx.com/uploads/abc.jpg），但代码里用 public_path('uploads/abc.jpg') 找不到文件，因为返回的是 /var/www/vhost1/public/uploads/...，而真实文件在 /var/www/myapp/public/uploads/...。
立即学习“PHP免费学习笔记（深入）”；
- 不要靠猜测路径，直接在控制器里打印
echo public_path();和echo __DIR__;对比 - 若发现偏差，手动覆盖 public 目录路径：在
bootstrap/app.php开头加App::usePublicPath('/var/www/myapp/public'); - 避免用
alias映射整个public目录；优先用root /var/www/myapp;+location / { try_files $uri $uri/ /index.php?$query_string; }
多域名共用同一套代码时上传目录隔离怎么做
一个 ThinkPHP 项目绑了 user.example.com 和 admin.example.com，但你希望用户上传走 public/uploads/users/，后台上传走 public/uploads/admins/——不能只靠域名判断再拼路径，否则容易绕过、难维护。
关键点在于：ThinkPHP 的文件上传逻辑本身不感知域名，所有隔离必须在业务层显式控制，且要避开 $_SERVER['HTTP_HOST'] 被伪造的风险。
- 在中间件或基类控制器中，根据可信配置（如路由分组、子域名预设白名单）设置上传上下文，例如
$this->uploadContext = 'admin'; - 构造路径时用
public_path("uploads/{$this->uploadContext}/" . $filename)，而不是直接解析HTTP_HOST - 如果用
think\filesystem\Driver，可在 disk 配置里动态传参：Filesystem::disk('local')->put("{$context}/{$filename}", $content) - 别忘了同步更新前端表单的隐藏字段或 API 路由前缀，确保前后端上下文一致，否则上传后 URL 生成会出错
storage_path() 和 public_path() 混用导致线上 404
有人图省事把上传文件存到 storage_path('app/uploads')，然后在模板里直接写 <img src="/storage/app/uploads/xxx.jpg">——这在本地开发可能好使（因为 php think serve 自动映射），但上线后 Nginx 不会自动代理 /storage 路径，必然 404。
根本原因：ThinkPHP 的 storage_path() 是纯服务端路径，不对外开放；只有 public_path() 下的资源才天然可被 Web 服务器直接响应。
- 上传到
storage_path()的文件，必须通过控制器输出（用response()->file()），不能直接裸露 URL - 想用静态 URL 就必须存到
public_path()下，并确保该目录在 Web 根目录内 - 如果真要隔离存储位置，可用符号链接：上线后执行
ln -sf /data/uploads public/uploads，让物理路径外移，逻辑路径不变
最易被忽略的一点：缓存配置。改完路径后，务必清空 runtime/cache/，否则 ThinkPHP 可能还在用旧的路径缓存值，连调试信息都显示不准。
