ThinkPHP8路由规则变更适配指南-ThinkPHP-PHP中文网

tp8路由生效需四者同步对齐：配置位置（app/route/app.php或子应用对应路径）、app_route开关显式启用、执行route:clear清除缓存、注解路由需独立安装并初始化；伪静态须配合nginx root指向子应用public目录及完整fastcgi参数。

thinkphp8路由规则变更适配指南

TP8 路由规则不是“改写法就行”，而是配置位置、开关状态、缓存机制、多应用上下文四者必须同步对齐；漏掉任一环节，php think route:list 看不到路由，访问直接 404。

TP8 的路由定义不再接受 config/route.php 或根目录下任意 route.php；所有具体路由规则必须落在对应应用的 app/route/app.php（单应用）或 app/admin/route/app.php（多应用子应用）中。

若项目是多应用结构（如含 app/admin），却把 /admin/login 路由写在主应用的 app/route/app.php，框架根本不会加载它——admin 请求压根没进这个文件
文件开头必须有 use think\facade\Route;，否则 Route::get() 等调用会报类未找到
若误将规则写入 config/route.php，需全部剪切、清空该文件，并执行 php think route:clear

TP8 默认关闭路由解析，即使路由文件存在且语法正确，app_route => true 缺失时，请求会退化为传统「模块/控制器/操作」硬路径匹配，/hello 永远找不到 index/hello。

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

检查 config/app.php（主应用）和 app/admin/config/app.php（子应用）中是否都有 'app_route' => true，值必须是布尔 true，不能是字符串 "true" 或数字 1
多应用下，子应用的 app_route 不继承主应用配置，每个子应用都要单独配
修改后必须运行 php think route:clear，否则旧缓存仍生效

注解路由（#[Get]、#[Route]）在 TP8 中是独立扩展，默认不激活，不报错也不提示，只会在 php think route:list 中彻底消失。

确认已执行 composer require topthink/think-annotation
在 app/bootstrap.php 或自定义服务提供者中调用 AnnotationRoute::init()
检查 config/annotation.php 中 'route' => ['enable' => true] 是否为 true
多应用下，config/annotation.php 的 'controllers' 必须显式列出所有应用控制器命名空间，例如：['app\controller', 'app\admin\controller']，路径用双反斜杠
#[Get] 不支持 middleware、domain、pattern，要用这些功能必须改用 #[Route]

伪静态本身没问题，但 TP8 多应用模式下，/admin/login 能否被识别为 admin 应用，取决于 Nginx/Apache 是否把请求完整交到 app/admin/public/index.php —— 而不是主应用的入口。

Nginx 的 root 必须指向子应用的 public 目录（如 /path/to/project/app/admin/public），不是项目根目录
try_files $uri $uri/ /index.php?$query_string; 中的 /index.php 是相对 root 的，所以 root 设对了，才真正命中子应用入口
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 这一行不能少，且依赖 $document_root 由前面的 root 正确赋值
若用 domain_bind，键名必须和浏览器地址栏完全一致（www.example.com ≠ example.com，localhost:8000 必须带端口）