ThinkPHP未定义路由默认抛出RouteNotFoundException异常而非跳转404页面；TP6需用Route::group()->miss()闭包指定响应，TP5.1需Route::any()兜底，前后端分离应返回JSON而非HTML，动态场景推荐中间件兜底处理。
ThinkPHP 未定义路由直接报错而不是跳转 404 页面
默认情况下，ThinkPHP 不会自动把未匹配的路由导向 404 页面，而是抛出 think\exception\RouteNotFoundException 异常 —— 这个异常如果不被捕获或配置兜底，就会显示白屏或调试信息，线上环境尤其危险。
关键不是“怎么写一个 404 页面”，而是“让框架在路由不匹配时，不抛异常，而是走你指定的响应逻辑”。
- 检查
config/route.php中是否设置了'miss' => 'index/Error/miss'（TP6）或'route_complete_match' => false（影响匹配宽松度） - TP6 推荐用路由分组 +
miss闭包：在app/route/app.php里写Route::group('', function () { /* 其他路由 */ })->miss(function () { return view('public/404'); }); - TP5.1/TP5.2 需在
route/route.php末尾加Route::any('[:id]', 'index/Error/miss')->ext('html');，但注意这会覆盖所有未匹配请求，包括真实存在的静态资源路径（如/static/css/app.css），容易误伤
自定义 404 响应返回 JSON 而不是 HTML 页面
前后端分离项目里，前端期望的是 404 状态码 + JSON 提示，而不是渲染一个 HTML 模板。这时候不能只靠 miss 方法返回 view()，得手动构造响应。
- TP6 中，在
miss闭包里用json(['code' => 404, 'msg' => 'Not Found'])->code(404) - TP5.1 中需先调用
\think\Response::create()，再设状态码，例如：return Response::create(['code'=>404,'msg'=>'route not found'],'json')->code(404); - 注意：如果全局开启了
url_html_suffix，而请求没带.html后缀，可能根本进不到miss，而是被 URL 解析层提前拦截，此时要检查config/app.php的'url_html_suffix' => ''是否为空或合理
中间件中统一拦截未匹配路由（绕过 route.php 配置）
当项目路由动态加载、或需要根据请求头/域名做差异化 404 处理时，miss 配置不够灵活，更适合用中间件兜底。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 新建中间件
app/middleware/RouteFallback.php，在handle()里判断$request->routeInfo() === null或!$request->routeIsDefined()（TP6.3+） - 注意顺序：该中间件必须放在路由解析之后、控制器执行之前，即注册在
app/middleware.php的'before_route' => []之后，或使用->append()显式追加到中间件队列尾部 - 别在中间件里直接
throw new HttpException(404)—— 这又回到异常流程，应该直接return json(...)->code(404)
TP5.1 升级到 TP6 后 404 配置失效
TP6 彻底重构了路由调度机制，miss 不再是全局配置项，也不再支持字符串控制器写法（如 'index/404'），必须是闭包或可调用数组。
- 旧配置
'route_not_found' => 'index/Empty/index'在 TP6 完全无效，删掉，改用分组miss - TP6 默认开启严格模式（
route_complete_match => true），导致/user/123/extra匹配不上/user/:id，看起来像 404；如需兼容，设为false，但会轻微降低路由性能 - 调试时用
php think route:list查看实际注册的路由表，确认miss行是否存在，而不是凭感觉改配置
最易被忽略的是：TP6 的 miss 只对「路由规则完全未匹配」生效，不处理控制器方法不存在、或者中间件抛出的异常。真要全覆盖，得配合 app/exception/Http.php 里的 render() 方法捕获 RouteNotFoundException。
