ThinkPHP迁移public目录后需同步调整Nginx root、APP_PATH/RUNTIME_PATH路径、URL生成配置及CDN缓存策略，否则导致404、样式丢失、缓存错乱等问题。
public 目录被挪动后，Nginx 404 或直接暴露 index.php
ThinkPHP 默认要求 public 是 Web 服务器的根目录（DocumentRoot），否则静态资源（css、js、images）路径全错，且 index.php 可能被当成普通文件下载或 404。常见错误现象是首页能打开但样式丢失、AJAX 接口返回 404、或者访问 /index.php/route 报 500（因为 $_SERVER['SCRIPT_NAME'] 和实际路径不匹配）。
解决关键是让 Web 服务器「假装」public 还在原位，哪怕它物理位置变了：
- Nginx 必须把
root指向新public路径，不能只改alias；否则try_files $uri $uri/ /index.php?$query_string会找不到index.php - Apache 需确保
.htaccess文件仍在新public目录下，且AllowOverride All已启用；否则重写规则失效，所有路由都 fallback 到 404 - 如果用 Swoole 或 RoadRunner，
public路径变更不影响运行时，但必须同步更新server.php中的static_handler配置指向新路径，否则静态资源 404
APP_PATH 和 RUNTIME_PATH 的路径依赖没同步更新
ThinkPHP 启动时靠 public/index.php 里的 define('APP_PATH', __DIR__ . '/../app/'); 定位应用目录。一旦 public 移动，这个相对路径就断了——常见错误是报 require(): Failed opening required '.../app/common.php' 或 RuntimeException: Can't write cache file。
必须手动修正这些常量定义：
立即学习“PHP免费学习笔记（深入）”；
-
APP_PATH要按新public位置重新计算，比如新public在/var/www/myapp/web/，那APP_PATH就该是/var/www/myapp/app/ -
RUNTIME_PATH建议绝对路径，避免依赖相对定位；尤其注意磁盘权限：Web 进程用户（如www-data）必须有写入权限，否则日志、缓存、模板编译全失败 - 别漏掉
EXTEND_PATH和VENDOR_PATH（如果自定义过），它们同样受public位置影响
URL 生成函数（url()、Url::build()）输出路径异常
ThinkPHP 的 URL 生成依赖 request()->root()，而它默认从 $_SERVER['SCRIPT_NAME'] 和当前请求 URI 推导。一旦 public 不再是 Web 根目录，root() 就会算错，导致 url('index/hello') 输出 /index/hello（少了一层子路径）或 /public/index/hello（多了一层）。
修复方式不是改函数调用，而是配置运行时上下文：
- 在
public/index.php开头加$_SERVER['SCRIPT_NAME'] = '/subdir/index.php';（若部署在子目录） - 或在
config/app.php中显式设置'url_domain_root' => '/subdir'（适用于 Nginx alias 或子目录部署） - 更稳妥的做法是用
Url::build()时传['domain' => true]强制带域名，避免路径推导干扰
CDN 或反向代理下静态资源 404 或缓存错乱
生产环境常配 CDN 或 Nginx 缓存静态资源，但 public 路径一变，CDN 的缓存 Key（比如基于 URI 路径）就和源站实际文件路径对不上。典型表现是刷新页面 CSS 不生效、图片显示为 404，但直连源站正常。
关键不是清 CDN 缓存，而是确认源站响应头和路径一致性：
- 检查 Nginx 是否把
public/static/映射到了正确物理路径，且location ~* \.(js|css|png|jpg)$块里没有遗漏root或alias配置 - 确认 ThinkPHP 的
__STATIC__模板变量是否仍指向正确 URL（它由request()->root()决定，同上一个问题） - 如果用了版本号控制（如
static/css/app.css?v=123），确保构建脚本生成的哈希值对应的是新public下的真实文件，而不是旧路径残留的缓存
路径变更本身不难，难的是所有隐式依赖它的环节：Web 服务器配置、PHP 常量、URL 推导逻辑、CDN 缓存策略、甚至运维部署脚本——漏掉任意一个，线上就出半截问题。
