根本原因是全局路由文件臃肿且子应用路由未被主动加载；需按业务域拆分并显式调用route::import()导入，子应用路由文件必须存在且路径名严格匹配，注解路由须扩展scan_path并确保php版本≥8.0。
ThinkPHP 8.0项目上线后路由加载变慢、子应用访问404、热更新失效，根本原因是全局路由文件臃肿且子应用路由未被主动加载——app/route/app.php里写满千行规则，而app/admin/route/app.php这种文件根本没被框架看到。
拆分全局路由：按业务域动态导入
打开项目根目录下的 app/route/app.php，删掉所有原始路由定义，只保留一行：
Route::import('api');
Route::import('admin');
Route::import('mobile');
这一步必须做。ThinkPHP 8 不会自动扫描子目录下的路由文件，【不显式调用 Route::import()，对应子应用的路由就永远不生效】。
在 route/api.php 中写：
Route::import('api/v1', 'api/v1');
Route::import('api/v2', 'api/v2');
注意第二个参数是子路径名，大小写敏感。比如你建了 route/api/v1/order.php，就必须写 'api/v1'，不能写 'API/V1' 或 'apiv1'。
子应用路由导入：必须显式声明路径与应用名
进入 app/admin 目录，确认存在 route/app.php 文件。若不存在，请手动创建。
在 config/route.php（或 app/route/app.php）中添加导入语句：
Route::import('admin', 'admin');
这个 'admin' 是第二个参数，必须和 app/admin 目录名完全一致。漏掉这行，访问 admin.yoursite.com/login 就会直接报 404，而不是跳转失败或提示错误。
在 app/admin/route/app.php 中，不要写 Route::group('admin', ...) 包裹全部路由——这会让实际 URL 变成 /admin/admin/login，多出一层前缀。直接写具体路由即可：
Route::get('login', 'Index/login');
避免路由冲突：命名唯一性与闭包隔离
第一步：检查所有路由是否都设置了 ->name()。
执行命令 php think route:list，查看输出中 Name 列为空的行——这些就是未命名路由，必须补全。
第二步：统一命名格式，例如：
→ api.v1.user.list
→ admin.dashboard.index
→ mobile.order.create
第三步：禁止在同一个 Route::group() 内混用闭包路由和控制器路由。如果临时加调试接口，闭包路由必须加前缀：
Route::get('ping', function () { return 'ok'; })->name('dev.ping');
闭包和控制器同名时，后者会静默覆盖前者，且不会报错。前端调用老接口时返回 404，排查成本极高。
注解路由启用：扩展安装与扫描范围修正
方法一：安装注解扩展
composer require topthink/think-annotation
方法二：修改 config/annotation.php
找到 'scan_path' 配置项，把默认的 ['app\controller'] 改为：
['app\controller', 'app\admin\controller', 'app\mobile\controller']
这一步不可跳过。ThinkPHP 8 注解扫描器默认只认 app/controller，【不手动扩展 scan_path，admin 应用里的 #[Route] 完全不会被识别】。
方法三：确保 PHP 版本 ≥ 8.0，否则 #[Route] 语法直接解析失败，报 Parse Error。
强制刷新路由缓存
删除 runtime/route/ 目录下全部文件。
执行命令：
php think route:clear
在 Swoole 或 RoadRunner 环境下，仅删缓存不够，必须重启服务进程，否则旧路由规则仍驻留在内存中。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
