ThinkPHP5路由生效需同时开启config/app.php中'url_route_on'=>true且合理配置'url_route_must'，并清除runtime缓存；动态参数必填用:id、可选用[:id]；URL重写须匹配入口文件；上线前必须执行php think optimize:route生成路由缓存。
ThinkPHP5路由开关必须在config/app.php里配，不是只改route.php
很多人改完route.php发现路由完全不生效，根本原因是没动核心开关。ThinkPHP5路由不是“注册了就跑”，而是依赖两个硬性配置项：
-
'url_route_on' => true：必须为true，否则Route::get()等所有注册全部被忽略 -
'url_route_must' => false（推荐初学者设为false）：设为true后，任何没明确定义的 URL（包括首页/）都会直接 404——常有人开了url_route_on又忘了关url_route_must，结果连/index/index都打不开，误以为框架坏了
这两个值必须同时生效，缺一不可。改完config/app.php后无需重启服务，但要清空runtime/目录下缓存（或至少删掉runtime/route.php），否则旧缓存会掩盖配置变更。
动态参数写法：:id和[:id]语义完全不同
ThinkPHP5 对参数是否必填极其敏感，冒号前加不加方括号直接决定匹配行为：
-
'user/:id'→ 必须带值，/user/123OK，/user直接 404 -
'user/[:id]'→ 可选，/user和/user/123都匹配，但控制器中需手动提供默认值：input('id', 'default')或方法参数设默认值：public function index($id = 'default') - 多个参数混用时顺序不能错：
'blog/:year/:month/[:day]'合法；'blog/:year/[:month]/:day'会导致/blog/2026/5匹配失败——因为[:month]后面还跟了必填:day，引擎无法回退补全
另外，完整路径匹配要用$结尾：'api/status$'只响应/api/status，不响应/api/status/或/api/status/extra。这个符号极易漏写，却直接影响 API 兼容边界。
立即学习“PHP免费学习笔记（深入）”；
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
Apache/Nginx 的 URL 重写规则必须匹配 ThinkPHP 的入口模式
ThinkPHP5 默认使用 PATH_INFO 模式解析 URL，所以 Web 服务器必须把所有非静态资源请求转发给index.php。常见错误是直接复制网上泛用规则，却不核对入口文件名：
- Apache：
.htaccess里RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]前提是入口文件叫index.php；如果用了admin.php，就得改成admin.php/$1 - Nginx：
rewrite ^(.*)$ /index.php?s=/$1 last;中的s=是 ThinkPHP 内部识别 PATH_INFO 的关键参数，不能写成s=/或漏掉s= - IIS：需安装 URL Rewrite 模块，并导入规则；若用
web.config，<match url="^(.*)$">后必须有<action type="Rewrite" url="index.php?s={R:1}" />，否则变量不传递
验证是否生效：访问一个不存在的路径如/test/abc，如果返回 404 是 Web 服务器没转发；如果返回 ThinkPHP 的“找不到路由”提示，说明重写已通，问题在路由定义本身。
上线前必须执行php think optimize:route
开发阶段不缓存路由影响不大，但生产环境每次请求都重新加载并解析全部route.php规则，性能损耗明显。缓存命令不是可选项：
- 运行
php think optimize:route生成runtime/route.php - 确保
runtime/目录可写，且部署脚本没把它设为只读 - 每次修改
route.php后必须重跑该命令，否则新规则永不生效——这是线上 404 最隐蔽的原因之一
缓存文件一旦生成，ThinkPHP 就不再读取route.php原始内容。如果你在调试时怀疑缓存干扰，最稳妥的做法是删掉runtime/route.php再手工触发一次命令，不要依赖自动清除逻辑。
