route.php 配置需满足加载路径、命名空间、缓存清理三条件才生效；单应用必须用 route/app.php 并声明 use think\facade\Route，多应用放对应 app/{name}/route/app.php，自定义文件名需修改 config/app.php 中 'route_config_file'，改后须执行 php think route:clear。
route.php 配置不是写完就生效，必须满足加载路径、命名空间、缓存清理三个硬性条件，缺一不可。
route.php 文件放哪？加载路径有严格约定
ThinkPHP 6+ 默认只自动加载 route/app.php（单应用）或 app/{name}/route/app.php（多应用）。你随便新建个 route/api.php 或 route/admin.php，只要文件名不是 app.php，且没在配置里显式引入，它就不会被加载。
- 单应用项目：路由必须写在
route/app.php，开头必须有use think\facade\Route; - 多应用项目：每个应用的路由应放在
app/index/route/app.php、app/admin/route/app.php等对应路径下 - 如果想用自定义文件名（如
route/api.php），需在config/app.php中修改'route_config_file' => 'api.php'，否则无效
为什么写了 Route::get() 却 404？检查这三件事
最常见的是“写了但没生效”，本质是框架根本没读到你的规则。不是语法错，是加载链断了。
- 确认
config/app.php中'app_route' => true是布尔型true，不是字符串"true" - 改完
route/app.php后，必须执行php think route:clear，否则 runtime 缓存仍用旧规则 - 命令行启动服务（如 Swoole）时，要加
--with-route参数，否则路由不初始化
动态参数和正则约束怎么配才安全？
:id 这种写法默认匹配任意非斜杠字符，/user/abc123 也能过，但控制器里 read($id) 接收到的是字符串，可能引发类型错误或 SQL 注入。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 必须用
->pattern()显式约束：例如Route::get('user/:id', 'user/read')->pattern(['id' => '\d+']) - 多个参数要逐个约束：
->pattern(['id' => '\d+', 'name' => '[a-zA-Z]+']) - 中文支持需手动放开：
[\x{4e00}-\x{9fa5}a-zA-Z0-9_]+，但要注意 XSS 和路径遍历风险
强制路由模式下，漏掉根路径或 MISS 处理会直接 404
设了 'url_route_must' => true 后，框架不再回退到隐式 m/c/a 解析，所有请求都必须命中某条规则。这时两个地方最容易踩坑：
- 首页
/必须显式定义：Route::get('/', 'index/index')，否则访问域名直接 404 - 建议加全局未匹配兜底：
Route::miss(function() { return view('404'); });，避免裸奔报错 - 子域名路由（如
admin.example.com）必须独立注册，不能靠主域名路由继承
真正卡住人的往往不是语法，而是缓存没清、路径写错、配置项类型不对这些“看不见”的环节。每次改完 route.php，先跑一遍 php think route:list 看输出里有没有你写的规则，比反复刷新页面更省时间。
