ThinkPHP跨平台部署路由不生效的根本原因是配置开关未启用、文件位置错误、缓存未清、语法不匹配或参数无约束；需确保app_route为true、路由写入正确路径、清除缓存、使用语义化方法注册并添加正则约束。
ThinkPHP跨平台部署时路由不生效，常导致访问直接报404或跳转到默认控制器，根本原因不是代码写错，而是配置开关未启用、文件位置放错、缓存未清、语法不匹配或参数无约束。
确认路由开关已启用
ThinkPHP 6 默认关闭路由功能，哪怕 route/app.php 写得再规范，app_route 关闭就等于没写。
打开 config/app.php 文件，查找 'app_route' 配置项，确保其值为布尔型 true：【不可写成字符串 "true" 或数字 1】
若项目是多应用模式（如 app/admin/），需分别进入每个子应用目录，检查其内部的 config/app.php 是否也设置了 'app_route' => true —— 主应用配置不会自动继承到子应用。
立即学习“PHP免费学习笔记（深入）”；
改完立即执行命令行指令：php think route:clear，否则旧缓存会继续生效。
把路由规则写进正确文件
单应用项目：必须把路由规则写入 app/route/app.php。
多应用项目：每个子应用必须有自己独立的路由文件，比如 admin 子应用要写在 app/admin/route/app.php，而不是根目录的 config/route.php 或 app/route.php。
注意：config/route.php 只用于控制行为开关（如 url_route_must、url_html_suffix），【不承载任何具体路由映射逻辑】。误将规则写在这里，框架完全无视。
检查 app/route/app.php 文件顶部是否包含 use think\facade\Route; 声明，缺失会导致 Route 类无法识别，报 Class not found 错误。
用语义化方法注册路由
推荐优先使用 Route::get()、Route::post() 等方法，而非 Route::rule()。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
Route::get('user/:id', 'User/read') ✅ 正确：只响应 GET，中间件和验证器绑定准确。
Route::rule('user/:id', 'User/read') ❌ 危险：默认响应所有 HTTP 方法，POST 请求也能触发 GET 路由，极易引发 CSRF 漏洞或权限绕过。
带变量的路由（如 :id）必须配合语义化方法注册；若用 Route::rule()，必须显式传入 ['GET'] 或 'GET|POST' 第三参数，否则无法约束请求类型。
处理多应用跨路由访问
在根目录 route/app.php 中定义路由想指向子应用（如 index 应用的 Login 控制器），不能直接写 'Login/index'。
因为根目录路由解析时 app() 的应用名、控制器、操作均为 null，框架会尝试加载 app\controller\Login，而实际路径应为 app\index\controller\Login。
方法一：用完整命名空间调用
Route::rule('login', '\app\index\controller\Login@index');
方法二：全局指定应用上下文
app()->http->name('index');
Route::rule('login', 'Login/index');
两种方式任选其一，但必须确保 app() 在路由解析前已设置好应用上下文，否则仍会报控制器不存在。
变量匹配失败时加正则约束
ThinkPHP 默认用 / 作分隔符，若参数含斜杠（如 Base64 编码 token），:token 会截断到第一个 / 就停，导致匹配失败。
解决办法是在路由后链式添加 pattern() 方法：
Route::get('detail/:token', 'Index/detail')->pattern(['token' => '\S+']);
\S+ 表示非空白字符任意长度，能吞掉 URL 中的斜杠；避免用 .*，它会贪婪匹配到末尾，可能吃掉后续路由段。
