Route::miss()是ThinkPHP 6+唯一可靠的404兜底方式，必须置于所有路由之后并显式返回404状态码，否则因url_route_must未启用、通配路由拦截或状态码未设导致失效。
Route::miss() 是 ThinkPHP 6+ 中唯一可靠、路由层原生支持的全局 404 兜底方式，不是“可选方案”，而是必须用它来替代异常捕获或中间件拦截。
为什么 app_exception 里改 404 没用
ThinkPHP 的 RouteNotFoundException 确实会抛出，但前提是「路由系统已启动且尝试匹配后失败」。而实际中，绝大多数 404 并不触发该异常——因为请求压根没进到路由匹配环节。
-
url_route_must为false（默认）时，框架会退化为隐式路由，miss()不生效，app_exception也收不到这个异常 -
url_route_must为true但没配miss()，框架直接返回空响应或 404 状态码，不抛异常 -
app_exception类只捕获 PHP 异常，不捕获 HTTP 状态逻辑；你改了render()方法，对未匹配路由完全无效
Route::miss() 必须写在所有路由之后
它不是“默认路由”，而是“兜底开关”：只有前面所有 Route::get()、Route::post()、Route::resource() 都不匹配时才触发。顺序错，等于没写。
- 必须放在
route/app.php文件末尾，不能嵌套在Route::group()内部（除非你明确想限制作用域） - 不能写在
Route::any('[:all]', ...)这类通配路由之后——它会永远不被执行 - 多应用模式下，每个应用的
route/app.php都要单独加，不能只配主应用
返回值必须显式设 404 状态码
view('public/404') 或 response()->view(...) 默认返回 200 状态，浏览器和爬虫都当正常页面处理，SEO 和安全审计全失效。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
return response()->view('public/404', [], 404); - 前后端分离项目用 JSON：
return json(['code' => 404, 'msg' => 'Not Found'])->code(404); - 拒绝重定向：
redirect('/404')会让状态码变成 302，攻击者能探测路径存在性 - 模板里别调
url()辅助函数——路由未匹配时它可能报错，建议用硬编码路径或request()->url()
静态资源 404 和 miss() 冲突怎么办
开启 url_route_must => true 后，/static/js/app.js 这类路径也会被路由系统拦截，找不到规则就进 miss()，导致 JS/CSS 加载失败。
- 在
route/app.php最顶部加别名：Route::alias('static', 'static');，让/static/xxx直接映射到public/static/xxx - 或用正则规则放行后缀：
Route::rule(':path^.*\.(js|css|png|jpg|gif|woff2)$', 'static/:path', 'GET', ['ext' => '']); - 这两条都必须放在所有其他路由之前，否则会被后续规则覆盖
- 改完立刻清空
runtime/cache/，否则旧缓存路由还在生效
真正难的不是写那行 Route::miss()，而是搞清请求到底被谁拦下了：Web 服务器？URL 解析层？路由分发器？还是你的某条 Route::any() 把所有流量吞掉了。先看 Network 面板的状态码来源，再查日志，最后动代码。
