路由是 ThinkPHP 应用开发中最常打交道的组件之一，也是面试中区分候选人框架熟练度的高频考点。很多开发者能写路由规则，却说不清分组路由的匹配优先级、域名路由的底层实现，以及 MISS 路由的全局兜底逻辑。本文围绕这三个核心概念展开，结合源码设计与实战场景，帮你在面试中答出深度。
一、分组路由：不只是“加个前缀”
分组路由（Route Group）是 ThinkPHP 5.1 之后路由系统的重要特性，它允许将一组具有相同前缀、相同中间件或相同参数的路由规则聚合管理。
1. 基本用法与常见误区
Route::group('blog', function () {
Route::get(':id', 'blog/read');
Route::post(':id/comment', 'blog/comment');
})->prefix('index/')->middleware(AuthMiddleware::class);
这段代码定义了两条路由，实际访问路径为 /blog/:id 和 /blog/:id/comment，并统一应用了 index 控制器前缀和鉴权中间件。
面试中常见的误区是认为分组只是“路径拼接”。实际上，ThinkPHP 的分组路由在解析时会生成一个嵌套的规则树，分组本身可以嵌套，每一层都可以独立定义中间件、参数和变量规则。这意味着：
- 分组的
prefix影响的是控制器解析，而非 URL 路径； - 分组的
middleware会在路由匹配成功后、控制器执行前依次触发； - 分组内定义的变量规则（
pattern）会向下继承，子路由可覆盖。
2. 匹配优先级：谁先谁后
ThinkPHP 路由匹配遵循“先定义先匹配”原则，但分组路由的注册顺序会影响最终结果。具体来说：
- 先匹配静态路由（无变量），再匹配动态路由；
- 同一层级下，按注册顺序依次尝试；
- 分组路由整体作为一个规则节点参与排序，组内规则在组被命中后才继续匹配。
因此，如果存在 /blog/:id 和 /blog/list 两条规则，必须把 /blog/list 写在前面，否则 list 会被当作 :id 的值吞掉。这一点在面试中经常被追问，回答时最好能举出反例。
3. 延迟解析与性能
分组路由支持 Route::group 的懒加载模式。在大型应用中，将路由按模块分组并配合 route.php 的缓存机制，可以显著减少每次请求的路由解析开销。ThinkPHP 会将路由规则编译成静态数组缓存，分组结构在缓存中表现为嵌套的 rule 与 route 映射，命中时直接查表而非正则回溯。
二、域名路由：多站点与子域名的优雅解法
域名路由（Domain Route）用于根据请求的 Host 头匹配不同的路由规则，典型场景包括多站点部署、子域名区分模块、SaaS 多租户等。
1. 基本配置
Route::domain('admin.example.com', function () {
Route::get('user/:id', 'admin/user/read');
});
Route::domain('api.example.com', function () {
Route::post('v1/order', 'api/order/create');
});
当请求 admin.example.com/user/5 时，会命中第一条规则；请求 api.example.com/v1/order 时命中第二条。域名路由的匹配发生在路由解析的最外层，优先于普通路径路由。
2. 泛域名与二级域名绑定
ThinkPHP 支持泛域名解析，例如 Route::domain('*.example.com', ...) 可以匹配所有子域名。结合 Route::domain 的第二个参数，还可以将域名中的变量捕获为路由参数：
Route::domain(':sub.example.com', function () {
Route::get('info', 'tenant/info');
});
此时 $sub 会作为变量传入控制器，非常适合多租户系统按子域名隔离数据的场景。
3. 底层实现要点
域名路由在底层通过 RuleItem 的 domain 属性进行标记。路由检查时，Domain 规则会先于 Path 规则被遍历。匹配逻辑是：
- 获取当前请求的 Host；
- 与注册的域名规则逐一比对（支持完整域名和泛域名）；
- 命中后，将域名中的变量合并到路由变量中；
- 再进入组内路径规则匹配。
面试中如果被问到“域名路由和普通路由能否共存”，答案是肯定的，但域名路由优先级更高。如果同一个路径在域名路由和普通路由中都定义了，域名匹配成功时不会回退到普通路由。
三、MISS 路由：全局兜底与 404 定制
MISS 路由是 ThinkPHP 路由系统的“最后一道防线”，当所有注册路由都未命中时触发。它常用于自定义 404 页面、API 统一错误响应、或做路由转发。
1. 注册方式
Route::miss(function () {
return json(['code' => 404, 'msg' => '接口不存在'], 404);
});
也可以指定一个控制器方法：
Route::miss('index/error/notFound');
2. 与 404 异常的区别
很多开发者混淆 MISS 路由和 HttpException(404)。区别在于：
- MISS 路由：路由未匹配时触发，此时尚未进入控制器调度，属于路由层兜底；
- 404 异常：路由匹配成功但控制器或方法不存在，或业务逻辑主动抛出，属于调度层异常。
如果只注册了 MISS 路由，访问一个不存在的控制器方法时，仍然会走异常处理而非 MISS 路由。反之，如果路由规则未命中，即使控制器存在也不会执行。
3. 实战中的典型用法
在 API 项目中，MISS 路由常与版本控制结合：
Route::group('api/:version', function () {
// 各版本路由
})->pattern(['version' => 'v\d+']);
Route::miss(function () {
return json(['code' => 404, 'msg' => 'API 路由不存在'], 404);
});
这样能保证所有未定义的 API 路径都返回统一的 JSON 结构，而不是 HTML 错误页，对前端联调非常友好。
四、面试高频追问与答题思路
追问 1：分组路由的中间件执行顺序是怎样的？
答：外层分组中间件先执行，内层分组中间件后执行，最后执行路由自身中间件。执行顺序遵循“先进后出”的洋葱模型，与 Laravel 中间件一致。
追问 2：域名路由能否和分组路由嵌套使用？
答：可以。Route::domain 内部可以继续使用 Route::group，此时域名规则作为最外层节点，分组作为其子节点，匹配时先校验域名再校验路径。
追问 3：MISS 路由在路由缓存后还会生效吗？
答：会。MISS 路由会被编译进路由缓存文件，作为兜底规则存在。但需要注意，如果开启了强制路由模式（route_check_cache 或 url_route_must），未匹配路由会直接抛出异常，MISS 路由可能不会按预期触发。
追问 4：如何调试路由匹配失败的问题？
答：可以使用 Route::getRuleList() 查看已注册规则，或开启 app_debug 后通过 Trace 面板查看路由解析过程。另外，route.php 缓存文件中的规则顺序就是实际匹配顺序，对比即可定位问题。
结语
分组路由解决的是“组织与复用”，域名路由解决的是“入口区分”，MISS 路由解决的是“兜底与容错”。三者分别对应路由生命周期的不同阶段：注册、匹配、未命中。理解它们在源码中的位置和优先级关系，远比记住几个 API 更有价值。面试中能说清“为什么”和“什么时候用”，才是真正的加分项。
未经允许不得转载：任鹏个人博客 » ThinkPHP 面试精讲：分组路由、域名路由与 MISS 路由
