自定义路由文件不生效主因是框架未加载，ThinkPHP 5.0.16仅自动加载route/app.php；多应用模式下该文件被跳过，需确认app_multi_module为false或改用route/[app_name].php；修改后须清缓存（php think clear --route）并用php think route:list验证是否注册成功。
自定义路由文件不生效，90% 是框架压根没加载它——不是写错了，是根本没进到路由注册流程里。
route/app.php 是唯一被自动加载的路由入口
ThinkPHP 5.0.16 只认 route/app.php 这一个文件，其他任何路径（比如 route/extra.php、app/route.php、config/route.php）都不会被自动包含。你写了十页路由规则，只要不在 route/app.php 里，就等于没写。
常见错误包括：
- 把路由逻辑写在
route/route.php—— TP5 不读这个文件 - 在控制器或中间件里调用
Route::get()动态注册——启动阶段已过，不生效 - 用
require手动引入自定义文件，但没在route/app.php的顶层作用域执行（比如包在 if 里、函数里或闭包里）
多应用模式下 route/app.php 会被跳过
如果你启用了多应用（APP_MULTI_MODULE = true），TP5 会改走 route/[app_name].php 模式，此时 route/app.php 直接被忽略。
立即学习“PHP免费学习笔记（深入）”；
验证方法：在 route/app.php 开头加一行 die('loaded');，访问任意 URL 看是否中断。如果不中断，说明该文件根本没被执行——大概率是多应用模式干扰。
解决方式：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 确认
config/app.php中'app_multi_module' => false（默认就是 false，但有人会手动开） - 如果必须用多应用，就把路由按应用拆分，例如
route/admin.php、route/api.php，并在对应应用的配置中启用 - 别试图在多应用下“强行复用”
route/app.php，框架逻辑不支持
路由文件里写了闭包但没调用 Route::domain() 或 Route::group()
直接在 route/app.php 里写 Route::get('test', 'index/test'); 是有效的；但如果你写了 Route::group(['prefix' => 'api'], function () { ... }); 却忘了执行它，那整个闭包里的路由都白写。
更隐蔽的问题是子域名路由：Route::domain('api.example.com', function () { ... }); 必须满足两个前提才可能触发：
-
config/app.php中'route_domain_bind' => true（缺了这句，闭包直接被跳过，连 warning 都没有） - Web 服务器透传了
HTTP_HOST，且值精确匹配api.example.com（本地测试记得改/etc/hosts）
调试建议：在闭包第一行加 echo 'domain route triggered';exit;，看是否执行——不输出，就说明框架连匹配都没做。
修改后没清缓存或没验证实际加载顺序
TP5 路由在首次运行时会生成缓存文件 runtime/route.php。你改了 route/app.php，但缓存没清，框架就继续用旧规则。
强制刷新方式：
- 删掉
runtime/route.php文件（不是整个 runtime 目录） - 命令行执行
php think clear --route（TP5.0.16 支持） - 验证是否生效：运行
php think route:list，看输出里有没有你新加的路由
注意：php think route:list 显示的路由，才是框架真正“认”的路由。如果这里没有，页面访问必然 404，跟伪静态、Nginx 配置全无关系。
最常被忽略的一点：路由注册顺序不可逆。你在 route/app.php 里先写了 Route::any('', 'index/index');，后面又写 Route::get('user', 'user/index');，那 /user 就永远被第一条通配规则吃掉——这不是不生效，是生效得太过头了。
