ThinkPHP路由生效需同时满足启用开关、位置正确、语法规范、缓存刷新四前提；须设app_route=>true、写入app/route/app.php、用Route::get()等语义化方法注册、为:id加->where(['id'=>'\d+'])约束，并执行php think route:clear。
ThinkPHP 路由不是“写完就生效”的功能，必须满足启用开关、位置正确、语法规范、缓存刷新四个前提，缺一不可。很多 404 或跳转失败的问题，根源不在规则本身，而在配置链的某个环节被忽略。
确认路由功能已全局启用
框架默认可能关闭路由解析，尤其在 ThinkPHP 6 的部分安装模板中。需手动检查并确保生效：
- 打开 config/app.php，查找
'app_route' => true（TP6/8）或'url_route_on' => true（TP5），值必须是布尔型true，不能是字符串"true"或数字1 - 多应用项目（如
admin、api）需分别检查对应子应用的config/app.php，主应用设置不继承 - 修改后务必执行
php think route:clear清除路由缓存，否则旧规则仍会生效
把规则写进正确的文件路径
ThinkPHP 6+ 的路由定义有明确归属，错放文件等于没写：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 单应用项目：规则必须写在 app/route/app.php（不是
config/route.php或route/route.php） - 多应用项目：每个子应用有自己的路由文件，例如
app/admin/route/app.php，而非根目录下统一管理 - 文件开头必须包含
use think\facade\Route;，否则Route::get()等调用会报错 -
config/route.php仅用于行为配置（如url_html_suffix、force），不承载任何映射逻辑
用语义化方法注册常用路由
推荐优先使用 Route::get()、Route::post() 等方法，它们比 Route::rule() 更安全、更清晰：
立即学习“PHP免费学习笔记（深入）”；
-
Route::get('user/:id', 'User/read');—— 仅响应 GET，自动启用严格模式 -
Route::post('api/login', 'Api/Login/login');—— POST 请求专用，避免 CSRF 中间件错位 -
Route::match(['GET', 'POST'], 'form/submit', 'Form/handle');—— 明确限定多种方法 - 避免滥用
Route::rule('path', 'target', 'any')，它默认宽松匹配，易引发意外交互
给动态参数加类型约束
URL 中的 :id 或 <id></id> 不会自动校验格式，必须显式约束，否则可能传入非法值：
- 单条路由加约束：
Route::get('article/:id', 'Article/read')->where(['id' => '\d+']); - 全局变量规则（TP5/6）：
Route::pattern(['id' => '\d+', 'name' => '[a-zA-Z]+']);，之后所有含:id的路由均受控 - 注意正则写法：不用
^和$，框架会自动包裹；写成'^\d+$'反而无法匹配 - 参数名、URL 路径段顺序、
url()助手函数传参键名三者必须完全一致，否则生成 URL 缺失参数或匹配失败
