核心问题是框架无法识别子目录，需手动设置APP_BASE_PATH并配置Web服务器RewriteBase（Apache）或alias（Nginx），同时更新config/app.php中的app_url和base_url，清理runtime缓存确保路径一致。
ThinkPHP部署在二级目录（比如 https://example.com/myapp/）时，核心问题不是路由没开，而是框架无法正确识别当前运行在子目录下，导致 URL 生成错误、静态资源 404、入口不触发。关键在于让服务器把路径「透传」给框架，并让 PHP 层明确知道 base path。
确认项目结构和入口位置
ThinkPHP 6+ 要求 Web 服务器的 Document Root 指向 public/ 目录。如果你要把整个项目放在二级目录（如 /var/www/html/myapp/），那么实际可访问路径是 /myapp/，而 public/index.php 就是这个子目录下的入口文件。
- 不要把
public/直接放到网站根目录——这会破坏安全设计 - 确保浏览器访问地址形如
https://example.com/myapp/，而不是https://example.com/ - 检查
public/下是否存在index.php和.htaccess（Apache）或对应 Nginx 配置
Web 服务器配置要匹配子目录路径
Apache 和 Nginx 的处理逻辑不同，但目标一致：让请求准确落到 public/index.php，并把原始 URI 完整传递过去。
-
Apache：在
public/.htaccess中必须添加RewriteBase /myapp/（结尾斜杠不能少），否则重写会指向根目录 -
Nginx：推荐用
alias方式，例如：
location /myapp/ {<br> alias /var/www/html/myapp/public/;<br> try_files $uri $uri/ /myapp/public/index.php?$query_string;<br>}
注意alias后路径必须以/结尾，且try_files中的/myapp/public/index.php是相对于 URI 的路径
手动声明 APP_BASE_PATH 防止路径推导出错
ThinkPHP 默认靠 $_SERVER['SCRIPT_NAME'] 推导 base path，但在子目录 + 伪静态环境下常被截断。最稳妥的方式是在 public/index.php 开头显式定义：
立即学习“PHP免费学习笔记（深入）”；
- 在
require __DIR__.'/../vendor/autoload.php';前加入：define('APP_BASE_PATH', '/myapp/'); - 然后在
config/app.php中设置：'app_url' => 'https://example.com/myapp','base_url' => APP_BASE_PATH, - 这样
url()函数生成的链接（如url('index/index')）才会带前缀/myapp/index/index
清理缓存并验证资源路径
配置改完后，别忘了清空 runtime/ 目录下的缓存，否则旧路径可能被固化。
- 静态资源（CSS/JS/IMG）404？检查 HTML 中的引用是否用了相对路径（如
href="static/css/app.css"）——应改为href="/myapp/static/css/app.css"或用__ROOT__/static/... - 访问
https://example.com/myapp/时出现空白页或 500？查看 PHP 错误日志，常见原因是alias路径权限不足或fastcgi_param SCRIPT_FILENAME指向错误 - 用
php think route:list看不到预期路由？先确保能正常访问首页，命令行环境不反映子目录上下文
