TP6路由匹配失败主因是Web服务器未将请求交由PHP处理，导致框架未启动；典型表现为/index.php/user/123 404但加?s=正常，需检查Nginx try_files、Apache .htaccess或IIS URL重写配置。
TP6 路由匹配失败，90% 是 Web 服务器没把请求交给 PHP
不是你路由写错了，是 public/index.php 根本没执行。Nginx/Apache 直接返回了原生 404，框架连启动机会都没有。
典型现象：/index.php/user/123 404，但加 ?s=/user/123 就正常——说明 PathInfo 解析失败。
- Nginx 必须在
location /块里写try_files $uri $uri/ /index.php?$query_string; - 若用了
fastcgi_split_path_info，必须配对写fastcgi_param PATH_INFO $fastcgi_path_info;，否则$_SERVER['PATH_INFO']为空 - Apache 用户检查
public/.htaccess是否生效：确认AllowOverride All已开启，且mod_rewrite已启用 - Windows IIS 必须装 URL Rewrite 模块，并导入
public/web.config
Route::pattern() 不生效？优先级和作用域搞错了
Route::pattern() 只约束含 :param 占位符的规则路由，对正则路由（Route::rule('^/api/\d+$', ...)）或闭包路由完全无效。
常见踩坑点：
- 把
Route::pattern()放在某条路由注册之后 → 该路由不受约束 - TP6.0.3 及更早版本中，group 嵌套时外层
pattern不会继承到内层 → 所有含动态参数的路由，应在最内层显式调用->pattern() - pattern 匹配失败不报错、不拦截，只是把原始字符串透传进控制器 →
/user/abc仍会进user/read方法，$id值就是"abc"，后续全靠业务代码校验 - 正则字符串里不能加
^和$，框架会自动包裹；写成'^d+$'反而匹配失败
Route::miss() 为什么没触发？它根本不是“404 页面”
Route::miss() 是匹配失败后的回调钩子，不是兜底视图入口。它不经过中间件，也不自动设 HTTP 状态码，返回值必须是 thinkResponse 实例。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
常见失效原因：
- 放在所有路由定义之前 → 被前面的通配规则（如
Route::any('[:all]', ...)）提前吞掉 - 返回
view('404')而不是response()->view('404', [], 404)→ 触发“响应已发送后输出”致命错误 - Nginx 配置了
error_page 404 /404.html;→ Web 服务器抢在 PHP 前返回 404，Route::miss()根本没机会执行 - 多应用模式下，在全局
app/route/app.php注册无效 → 必须放在对应应用的路由文件里，如app/admin/route/app.php
为什么 :/ 这种写法总导致 404？RFC 层面就不合法
URL 路径段中出现 :/（如 /user:/id）违反 RFC 3986 对 pchar 的定义，多数框架和前端路由库直接拒绝解析。
实际表现：
- Vue Router 把
/user:/id当作非法路径段，跳过匹配，返回 404 - Express 的
app.get('/:version/users')拿不到/api:v1/users中的v1，因为:不被识别为参数起始符 - Next.js App Router 编译时报
invalid route segment "api:v1" - React Router v6 静态分析器标记
path="/:api:/v1"为不可达路由
真正能跑通的写法只有两种：用普通斜杠分隔（/user/v1/profile），或把冒号转义为 %3A 后拼接查询参数（/user/v1?version=1.0）。别试图在路径里硬塞 :。
