ThinkPHP 8 子目录部署需严格对齐 APP_URL 与真实访问路径（如 https://example.com/myapp），并启用 URL_DOMAIN_DEPLOY=true；Apache 配 RewriteBase，Nginx 用 alias 或精准 root 配置，确保 REQUEST_URI 解析、静态资源路径及大小写完全一致。
ThinkPHP 8 的 APP_URL 和 URL_DOMAIN_DEPLOY 怎么配才生效
子目录部署失败，多半是 URL 生成和路由解析没对齐。ThinkPHP 8 默认假设项目部署在根目录，APP_URL 不只是影响资源链接，还会参与路由匹配前的路径截断——如果它没精确对应真实访问路径，url() 生成的链接会多一层或少一层，重写规则也容易失效。
实操建议：
-
APP_URL必须填完整协议 + 域名 + 子目录路径，比如部署在https://example.com/myapp/，就设为https://example.com/myapp（结尾不加斜杠） - 开启子目录部署必须显式设置
URL_DOMAIN_DEPLOY = true，否则框架不会尝试从请求 URI 中剥离子目录前缀 - Apache 下需确保
.htaccess中的RewriteBase与子目录一致，例如 RewriteBase /myapp/；Nginx 则要在 location 块里用alias或正确配置try_files，不能只靠 root
为什么 url() 生成的链接总是漏掉子目录
这不是缓存问题，也不是路由定义错了，而是 url() 内部依赖 Request::root() 推导基础路径，而 root() 又由 APP_URL 和当前请求的 REQUEST_URI 共同决定。一旦两者不匹配，比如 APP_URL 是 https://a.com/app，但实际通过 https://a.com/app/public/index.php 访问，root() 就可能误判为 /app/public，导致生成的 URL 缺失 /app。
排查和修复要点：
立即学习“PHP免费学习笔记（深入）”；
- 在控制器中打印
request()->root()和config('app.app_url')，确认二者是否逻辑一致 - 检查入口文件
public/index.php是否被移动过——ThinkPHP 8 要求入口必须在public/目录下，且 Web 服务器 DocumentRoot 指向此处，否则REQUEST_URI解析会偏移 - 避免在配置中用
$_SERVER['HTTP_HOST']动态拼APP_URL，子目录路径无法自动推导，必须硬编码
Apache 和 Nginx 的重写规则差异在哪
ThinkPHP 自带的 .htaccess 默认按根目录设计，直接挪到子目录下会 404。Nginx 同理，try_files $uri $uri/ /index.php?$query_string 这种写法在子目录里根本找不到 index.php。
关键区别和写法：
- Apache：在子目录的
.htaccess中必须加RewriteBase /your-subdir/，且RewriteRule的目标要写成index.php（不是/your-subdir/index.php），否则会二次跳转 - Nginx：推荐用
alias方式，比如location /myapp/ { alias /path/to/thinkphp/public/; try_files $uri $uri/ /myapp/index.php?$query_string; }；用root的话，location块内路径要和磁盘路径严格对齐，稍有偏差就 404 - 无论哪种服务器，都要确认 PHP 的
PATH_INFO支持已开启（特别是 CGI/FastCGI 模式），否则index.php/abc这类 PATHINFO 路由无法解析
子目录部署后静态资源 404 怎么定位
常见现象是 CSS、JS 加载 404，但页面能打开。这通常不是 ThinkPHP 配置问题，而是 Web 服务器对 public/ 下静态路径的处理逻辑被子目录干扰了。
检查顺序：
- 浏览器开发者工具里看 Network 标签，确认请求的静态资源 URL 是什么（比如是
/myapp/static/css/app.css还是/static/css/app.css），再对照服务器上文件实际位置 - 确认
public/static/目录确实存在且权限可读；如果用了软链，Nginx/Apache 默认不跟随，需额外配置 - ThinkPHP 的
__STATIC__模板变量由think\facade\Url::buildStaticUrl()生成，它依赖APP_URL和config('app.static_domain')，后者为空时才会拼接APP_URL . '/static'，别漏掉这个逻辑分支
最易被忽略的是：子目录名大小写必须和 APP_URL 完全一致，Linux 服务器区分大小写，/MyApp 和 /myapp 是两个路径。
