罗罗编程学习记录
本页内容 展开查看

06.5.3.4 路由规则与 URL 管理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii

06.5.3.4-001 urlManager 组件承担什么职责?

一句话结论

urlManager 负责两个方向:把请求 pathInfo 解析为路由与参数(入站),把路由与参数生成 URL(出站);规则表是两个方向共同的依据。

概念解释

入站匹配规则把 /post/123 映射到 post/view 与 id=123;出站 createUrl 按同一规则反向拼出美观路径。组件还控制是否隐藏入口脚本、URL 后缀与域名行为。

原理流程

  1. 请求到达后 request 提供 pathInfo。
  2. urlManager 按 rules 自上而下匹配,输出路由与参数。
  3. 生成 URL 时按路由反查规则,拼接参数与查询串。

代码或图示

// config/web.php 片段
'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [],
    ],
],

常见误区

  • 认为路由只在请求时匹配:出站生成同样依赖规则定义,规则缺失会回退到 query 形式 URL。
  • 把规则写进控制器:规则属于应用配置,控制器不参与路由匹配。

追问

  • 规则未匹配时默认行为?答:回退到默认路由解析形式(r=控制器/动作 或 pathInfo 直接作为路由),具体由配置决定。
  • 多应用如何隔离规则?答:模块可提供自身规则,应用规则与模块规则按层级叠加。

06.5.3.4-002 pretty URL 与 showScriptName 如何控制 URL 形态?

一句话结论

enablePrettyUrl=true 使用路径形式而非 ?r= 查询参数;showScriptName 控制 URL 是否保留入口脚本名,配合 Web 服务器重写规则把请求指向入口脚本。

概念解释

关闭 pretty URL 时 URL 形如 index.php?r=post/view&id=1;开启后变为 /post/view?id=1;showScriptName=false 再去掉 index.php 前缀,由 Nginx/Apache 重写保证所有路径仍进入入口。

原理流程

  1. 配置开关决定生成器输出格式。
  2. Web 服务器把静态资源以外的请求重写到入口脚本。
  3. urlManager 从 pathInfo 恢复路由。

代码或图示

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'suffix' => '',
],

常见误区

  • 只改配置不配服务器重写:去掉脚本名后请求找不到入口,出现 404 或静态目录误命中。
  • 以为 pretty URL 改变了控制器路由:路由标识不变,只是 URL 外观与解析方式变化。

追问

  • 后缀 .html 如何统一加?答:设置 urlManager 的 suffix,规则匹配与生成都按后缀处理。
  • 关闭 showScriptName 后相对链接如何基准?答:以应用 baseUrl 为基准,部署在子目录时需正确配置 baseUrl。

06.5.3.4-003 规则定义格式:pattern 如何映射到 route?

一句话结论

规则数组以 pattern(URL 模式)为键、route(控制器/动作路由)为值;pattern 中可含占位符,route 可引用占位符作为动作参数。

概念解释

最简规则是字符串到字符串;复杂规则用数组配置,包含 pattern、route、verb、defaults 等键。规则既可反向生成 URL,也承担入站匹配。

原理流程

  1. 登记 pattern 与 route 对应关系。
  2. 入站:pathInfo 命中 pattern,提取占位符值作为参数。
  3. 出站:路由与参数命中规则,反向拼出 pattern 形式 URL。

代码或图示

'rules' => [
    'post/<id:\d+>' => 'post/view',
    'posts' => 'post/index',
],

常见误区

  • pattern 与 route 方向写反:键是 URL 模式,值是内部路由,不可互换。
  • 规则只写字符串忽略参数约束:缺少正则的占位符会匹配任意片段。

追问

  • 规则能否指向闭包/控制器动作以外目标?答:常规规则指向控制器路由;扩展规则类可实现自定义匹配,具体能力以版本为准。
  • 一条规则能否服务多个动作?答:route 指向单一控制器动作;不同 HTTP 方法可用多条规则或 verb 配置区分。

06.5.3.4-004 参数占位符 <param:regex> 如何书写?

一句话结论

pattern 中用 <参数名:正则表达式> 声明命名参数与匹配约束;未写正则时占位符默认匹配除 / 外的片段,捕获值进入动作参数。

概念解释

占位符名称对应动作方法同名参数;正则限定取值范围,如 \d+ 限整数、[a-z-]+ 限 slug。未约束的占位符可能把含特殊字符的片段误匹配,应尽量给出正则。

原理流程

  1. 解析 pattern 中的占位符与正则。
  2. 入站匹配后把捕获组按名放入参数数组。
  3. 动作参数按名称绑定取值。

代码或图示

'rules' => [
    'article/<slug:[a-z0-9-]+>' => 'article/view',
    'user/<id:\d+>/profile' => 'user/profile',
],

常见误区

  • 正则里再嵌斜杠未转义:pathInfo 按斜杠分段,跨段占位符需特殊规则处理。
  • 占位符名与动作参数名不一致:参数取不到值,动作侧使用默认值或 null。

追问

  • 占位符能否匹配多级路径?答:默认分段匹配;需要通配多级时使用规则类或捕获剩余路径,配置方式以框架文档为准。
  • 正则大小写敏感吗?答:按 PCRE 规则书写,需要忽略大小写时在正则内加修饰符,具体写法以版本实现为准。

06.5.3.4-005 规则解析顺序为什么自上而下首匹配?

一句话结论

rules 数组按顺序逐条尝试,命中即返回;更具体、更严格的规则应排在通用规则之前,避免被宽泛规则抢先匹配。

概念解释

路由解析不做“最优匹配”,只做顺序首匹配。把 /post/<id:\d+> 排在 /post/<slug:...> 之前可以保证数字 id 走对应动作;顺序颠倒会导致路由错配。

原理流程

  1. 按数组顺序遍历规则。
  2. 每条规则尝试匹配 pathInfo 与 verb。
  3. 首次命中生成路由与参数,终止遍历。

代码或图示

'rules' => [
    'post/<id:\d+>' => 'post/view',      // 先:数字 id
    'post/<slug:[a-z-]+>' => 'post/by-slug', // 后:文本 slug
],

常见误区

  • 把通配规则放最前:后续具体规则永远不生效。
  • 调整规则后不验证两种片段:线上出现错路由才暴露顺序问题。

追问

  • 同一步段多条规则都命中时如何选择?答:以数组在先者为准,不比较规则复杂度。
  • 规则顺序影响出站生成吗?答:createUrl 反查同样按顺序找能表达该路由的规则,顺序影响最终 URL 形态。

06.5.3.4-006 HTTP verb 约束如何配置?

一句话结论

规则数组可设置 verb 为允许的 HTTP 方法(如 GET、POST);只接受匹配方法的请求,方法不符则跳过该规则,继续匹配下一条。

概念解释

verb 约束把路由与动作语义绑定:检索类动作只允许 GET,提交类动作只允许 POST。规则层 verb 与控制器 VerbFilter 可叠加,职责分别是路由匹配与动作前校验。

原理流程

  1. 规则声明允许方法列表。
  2. 入站匹配时先比对请求方法。
  3. 方法不匹配跳过规则;匹配通过后进入控制器。

代码或图示

'rules' => [
    [
        'pattern' => 'post/<id:\d+>',
        'route' => 'post/view',
        'verb' => 'GET',
    ],
    [
        'pattern' => 'post',
        'route' => 'post/create',
        'verb' => 'POST',
    ],
],

常见误区

  • 只在路由规则限 verb,控制器内不再防护:直接构造请求或其他入口仍可能绕过,动作层应保留 VerbFilter。
  • verb 写成小写:方法名按 HTTP 标准大写比较,写法以框架实现为准。

追问

  • 一条规则允许多个方法怎么写?答:verb 数组列出多个方法,如 ['GET', 'HEAD']。
  • 方法不匹配返回什么?答:规则跳过继续匹配;最终无匹配才走 404/默认路由,HTTP 405 行为需结合过滤器与错误处理器确认。

06.5.3.4-007 后缀 suffix 与域名 host 规则如何使用?

一句话结论

suffix 为所有 URL 统一追加路径后缀(如 .html);规则可绑定 host 限定子域名/域名,只有请求主机匹配时该规则才参与匹配。

概念解释

后缀常用于伪静态兼容旧链接;host 规则用于多站点/子应用按域名分流,例如后台域名匹配 admin 模块规则。host 匹配发生在 pathInfo 匹配之前。

原理流程

  1. 组件 suffix 参与规则匹配与 URL 生成。
  2. 规则带 host 时先校验请求主机。
  3. 主机与路径都命中才解析路由。

代码或图示

'rules' => [
    [
        'class' => yii\web\UrlRule::class,
        'host' => 'admin.example.com',
        'pattern' => 'dashboard',
        'route' => 'admin/dashboard/index',
    ],
],

常见误区

  • 配了 host 规则却不解析主机:请求域名不一致时规则不生效,表现为 404。
  • suffix 与 Web 服务器重写不一致:静态资源被当作带后缀路径解析,需在服务器层区分。

追问

  • 域名参数能否作为路由参数?答:host 字符串可含占位符,捕获值进入参数;具体支持以规则实现为准。
  • 多站点共用一套代码如何切分?答:按 host 规则分流到不同模块,应用组件配置按域名环境覆盖。

06.5.3.4-008 默认路由 defaultRoute 与尾斜杠行为如何控制?

一句话结论

defaultRoute 指定空 pathInfo 时进入的路由(通常为 site/index);规则可配置是否接受/重定向尾部斜杠,避免同一路径重复匹配。

概念解释

访问应用根路径时没有具体规则命中,urlManager 回退到 defaultRoute。尾斜杠规范化由规则与服务器配合处理:统一一种形态,另一种做 301/302 跳转以保证链接一致。

原理流程

  1. pathInfo 为空:使用 defaultRoute。
  2. 路径带尾斜杠:按规则配置判断匹配或重定向。
  3. 规范化后路由进入控制器。

代码或图示

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'defaultRoute' => 'site/index',
],

常见误区

  • 根路径 404 却不检查 defaultRoute:空路径没有显式规则时必须配置默认路由。
  • 同时接受带斜杠与不带斜杠两种形态:SEO 与缓存层面重复,应统一并跳转。

追问

  • 规则能否只匹配带尾斜杠?答:在 pattern 中表达斜杠形态;规范化重定向通常由规则类或服务器层完成。
  • defaultRoute 能否指向模块动作?答:可以,路由写模块前缀形式即可。

06.5.3.4-009 createUrl 如何生成相对路由 URL?

一句话结论

Url::toRoute() 或 urlManager 的 createUrl($route, $params) 按规则反查生成带查询参数的相对 URL;规则能表达的参数进入路径,其余参数作为 query string。

概念解释

入参为路由字符串与参数数组;生成器优先找能容纳参数的规则,占位符参数拼进路径,未被规则使用的参数追加为查询串。返回值相对站点根,不含主机与协议。

原理流程

  1. 传入路由与参数。
  2. 遍历规则找可生成该路由的规则。
  3. 占位符替换参数,剩余参数拼 query,输出相对 URL。

代码或图示

use yii\helpers\Url;

$url = Url::toRoute(['post/view', 'id' => 123, 'page' => 2]);
// 规则 post/<id:\d+> 命中后生成:/post/123?page=2

常见误区

  • 路由写成 post/view 但规则只配置了反向形式:生成回退为 query 形式,URL 不美观。
  • 参数值含中文/特殊字符:生成器负责编码,手工拼接 URL 会破坏编码。

追问

  • Url::to() 与 toRoute() 区别?答:to() 可处理字符串锚点、别名与路由数组,toRoute() 专用于路由生成;具体行为以 Url 助手文档为准。
  • 生成绝对路径用什么?答:使用 createAbsoluteUrl 或 Url::toRoute 带绝对模式。

06.5.3.4-010 createAbsoluteUrl 如何生成绝对地址?

一句话结论

createAbsoluteUrl($route, $params, $scheme) 在相对 URL 基础上拼接主机与协议,生成可外发的完整 URL(邮件链接、回调地址、开放平台回跳)。

概念解释

主机来自 request 的 host 配置,协议按当前请求 scheme 或指定 scheme;子目录部署时 baseUrl 也会纳入。绝对 URL 不能依赖客户端相对路径,必须在服务端确定基准。

原理流程

  1. 先按 createUrl 得到相对路径。
  2. 拼接 scheme、host、baseUrl。
  3. 返回完整 URL。

代码或图示

$link = Yii::$app->urlManager->createAbsoluteUrl(
    ['post/view', 'id' => 123],
    'https'
);

常见误区

  • 在命令行任务里直接生成绝对 URL:console 请求没有 HTTP host,需显式传入主机或从配置读取。
  • 协议写死 http:HTTPS 部署下生成的回调链接不可用,应按环境配置 scheme。

追问

  • 邮件中的链接用相对地址可行吗?答:不行,邮件客户端没有页面基准,必须生成绝对 URL。
  • 多域名应用如何选择 host?答:按站点配置覆盖 urlManager host 或在生成时传入目标域名。

06.5.3.4-011 路由如何解析到控制器动作?

一句话结论

路由按 / 分段:模块前缀、控制器标识、动作标识;控制器标识映射为控制器类(site → SiteController),动作标识映射为 actionXxx 方法,模块上下文决定命名空间。

概念解释

三段形式 module/controller/action;缺省动作取默认 action,缺省控制器取控制器默认值。类命名空间由模块 controllerNamespace 或应用约定决定,目录结构与命名空间必须一致。

原理流程

  1. 路由字符串按段拆分。
  2. 模块段进入模块上下文,解析控制器命名空间。
  3. 控制器类实例化,动作段映射为 action 方法并执行。

代码或图示

// 路由 api/v1/post/index
// 模块 api/v1,控制器 PostController,动作 actionIndex
class PostController extends yii\web\Controller
{
    public function actionIndex(): mixed
    {
        return $this->render('index');
    }
}

常见误区

  • 目录层级与路由段不一致:命名空间解析失败,控制器找不到。
  • 动作方法缺少 action 前缀:路由无法映射到方法。

追问

  • 控制器标识如何转类名?答:按约定把 kebab/小写标识转为 PascalCase 并拼 Controller,转换规则以框架实现为准。
  • 默认动作如何指定?答:控制器 $defaultAction 属性声明未给动作段时执行的方法。

06.5.3.4-012 规则参数与默认值 defaults 如何配合?

一句话结论

规则可在 defaults 中为占位符或动作参数提供默认值;入站未捕获该参数时使用默认值,出站生成时默认参数通常不进入路径。

概念解释

defaults 解决可选参数:规则模式可省略某段,缺省时填入默认路由参数;动作方法同名参数也可给 PHP 默认值,两层默认分别负责路由层与方法层。

原理流程

  1. 规则声明 defaults 键值。
  2. 入站匹配缺段时补默认参数。
  3. 出站生成时默认值参数省略,保持 URL 简洁。

代码或图示

'rules' => [
    [
        'pattern' => 'page/<page:\d+>',
        'route' => 'site/page',
        'defaults' => ['page' => 1],
    ],
],

常见误区

  • defaults 与动作默认值不一致:路由层补值后动作层不再触发默认值,两处约定要对齐。
  • 可选参数正则写成必填段:缺段时规则不匹配,defaults 无从生效。

追问

  • 默认参数能否作为路由区分依据?答:路由由 pattern 决定,defaults 只补值,不改变匹配形态。
  • 出站时默认值参数会出现在 query 里吗?答:规则默认值一般不写入路径;非规则参数仍会进入 query,具体生成行为以版本实现为准。

06.5.3.4-013 RESTful 路由如何组织复数资源?

一句话结论

REST 风格按资源复数命名(posts),用不同 verb 对应 index/view/create/update/delete 等动作;Yii 可通过多条规则或 URL 规则类把资源映射到控制器动作。

概念解释

资源集合路径对应列表与创建,单项路径对应查看、更新、删除;动作命名遵循 REST 约定,响应格式由 Response 组件统一输出 JSON。规则层负责方法与路径映射,控制器负责语义实现。

原理流程

  1. 为资源集合与单项分别声明规则。
  2. verb 区分读写操作。
  3. 动作返回数据,response 按 JSON 格式化。

代码或图示

'rules' => [
    'GET posts' => 'post/index',
    'GET posts/<id:\d+>' => 'post/view',
    'POST posts' => 'post/create',
    'PUT posts/<id:\d+>' => 'post/update',
    'DELETE posts/<id:\d+>' => 'post/delete',
],

常见误区

  • 动作名仍按传统 web 命名却配 REST 规则:语义与方法职责不对应,维护混乱。
  • 不做版本前缀:API 演进时路径无版本隔离,老客户端受影响。

追问

  • Yii 是否内置资源控制器规则生成?答:框架提供 REST 相关控制器与规则支持,具体特性(如自动复数映射)以 2.x 文档为准,3.0 由路由包配置表达。
  • 状态码如何与动作对应?答:动作通过 response 设置状态码,创建返回 201,删除返回 204 等,按 API 约定处理。

06.5.3.4-014 带 query 参数的 URL 如何生成?

一句话结论

createUrl 把规则未占用的参数追加为 query string,参数经 HTTP 编码;数组参数、锚点片段需要分别处理,不能手工拼未编码的字符串。

概念解释

路径占位符外的参数全部进入 query;分页、筛选、排序参数适合 query 表达。锚点 #fragment 不经过 urlManager 规则,由 URL 助手单独拼接。

原理流程

  1. 规则消耗占位符参数。
  2. 剩余参数 http_build_query 形式编码拼接。
  3. 需要片段时追加 # 与编码后的锚点。

代码或图示

$url = Url::toRoute([
    'post/index',
    'page' => 2,
    'tag' => 'php',
    'sort' => 'created_at',
]);
// /post/index?page=2&tag=php&sort=created_at

常见误区

  • 手工拼接 & 与参数值:中文、空格、符号未编码导致链接失效。
  • 把敏感筛选条件放进路径:路径可被缓存与日志记录,敏感条件放 query 或服务端会话控制。

追问

  • 数组参数如何编码?答:按框架 URL 助手规则生成 a[]=1&a[]=2 形式,读取时 request 取数组。
  • 生成的 query 顺序稳定吗?答:按参数数组顺序拼接;依赖顺序做缓存键时要自行排序归一化。

06.5.3.4-015 规则类选项与 extra 配置有哪些常用项?

一句话结论

数组规则可配置 pattern、route、verb、defaults、host、suffix 等选项;自定义规则类可实现匹配与生成逻辑,扩展框架内置规则能力。

概念解释

内置 UrlRule 处理常见模式;需要正则复用、多段捕获、特殊匹配时派生规则类覆盖 parseRequest 与 createUrl。规则选项在数组配置中声明,解析时传入规则实例。

原理流程

  1. 规则数组 class 指定规则实现。
  2. 选项注入规则实例属性。
  3. 入站 parseRequest、出站 createUrl 由规则类实现。

代码或图示

'rules' => [
    [
        'class' => \app\web\SliderUrlRule::class,
        'pattern' => '<year:\d{4}>/<slug>',
        'route' => 'archive/view',
    ],
],

常见误区

  • 规则类只实现入站不实现出站:生成 URL 时回退 query 形式,前后端链接不一致。
  • 把业务判断放进规则类:规则只负责匹配与生成,权限与校验留给过滤器和动作。

追问

  • 规则类单例还是每次请求新建?答:规则实例在 urlManager 配置后复用;有状态规则要注意跨请求状态隔离。
  • 如何调试规则匹配?答:临时打印 pathInfo 与遍历命中结果,或用请求日志确认最终路由。

06.5.3.4-016 URL 规范化与重定向如何落地?

一句话结论

规范化包括统一入口脚本形态、尾斜杠、后缀与大小写;不一致形态由规则/服务器返回重定向到规范 URL,避免重复索引与缓存分叉。

概念解释

常见场景:带尾斜杠访问无斜杠规范路径、旧 .php 链接、大小写不一致路径。重定向在请求早期完成,保留查询参数,选择 301(永久)或 302(临时)。

原理流程

  1. 请求路径与规范形态比对。
  2. 不一致时构造规范 URL。
  3. response 发送重定向状态码与 Location 头。

代码或图示

// 控制器内规范化示例(示意)
if ($this->request->getPathInfo() !== $normalized) {
    return $this->redirect($normalized, 301);
}

常见误区

  • 规范化重定向丢失 query 参数:筛选/分页链接跳转后参数丢失。
  • 循环重定向:规则与跳转目标互相指向对方,需核对规范路径生成。

追问

  • 301 与 302 如何选择?答:永久迁移用 301,临时变更用 302;浏览器缓存 301,调整不当时回滚困难。
  • 多后缀兼容旧链接怎么做?答:旧后缀规则入站兼容,出站统一新后缀,旧地址 301 到新地址。

06.5.3.4-017 模块内路由前缀如何解析?

一句话结论

模块路由以模块 ID 为前缀进入模块上下文;模块内控制器相对模块命名空间解析,模块可提供自己的规则集,规则前缀与模块标识保持一致。

概念解释

应用规则先剥离模块前缀,剩余路径交给模块控制器解析;模块规则配置可在模块类或应用配置中声明。嵌套模块按层级前缀依次剥离。

原理流程

  1. 路由首段匹配模块 ID。
  2. 模块实例化,控制器命名空间生效。
  3. 剩余控制器/动作段在模块内解析。

代码或图示

// 路由 admin/post/index → 模块 admin,PostController::actionIndex
class Module extends yii\base\Module
{
    public $controllerNamespace = 'app\\modules\\admin\\controllers';
}

常见误区

  • 模块规则缺少模块前缀:出站生成的链接回到应用控制器,跨模块 404。
  • 嵌套模块前缀层级写错:内层模块控制器解析到外层命名空间,类找不到。

追问

  • 模块能否自定义 URL 规则?答:可以在模块配置或模块类中返回规则;应用合并规则时按模块上下文处理。
  • 模块默认路由如何设置?答:模块内可配置默认控制器/动作,进入模块无前缀时使用。

06.5.3.4-018 Yii 3.0 路由器与中间件位置如何安排?

一句话结论

3.0 路由由独立路由包承担,匹配结果交给 PSR-15 中间件链与处理器;规则以配置数组/快速路由定义,请求响应为 PSR-7 对象,不再依赖 urlManager 组件门面。

概念解释

2.x 的 urlManager 在应用生命周期内解析路由;3.0 中间件链中可包含路由中间件,先匹配再分发到处理器。规则配置与容器装配解耦,可替换为其他 PSR 路由实现。

原理流程

  1. 配置注册路由到处理器/动作映射。
  2. 请求进入中间件链,路由中间件完成匹配。
  3. 匹配结果交给处理器生成响应。

代码或图示

PSR-7 Request
  → 中间件链(CORS、鉴权、路由)
    → 路由匹配
      → 处理器/控制器动作
        → Response

常见误区

  • 把 2.x rules 数组结构直接套到 3.0 路由包:3.0 路由定义 API 不同,需对照 yiisoft/router 文档。
  • 鉴权放在路由之后才做:应作为路由前中间件,未授权不进入处理器。

追问

  • 3.0 还能生成 URL 吗?答:路由包提供反向生成能力,具体 API 以路由包文档为准。
  • 中间件与 2.x 过滤器对应关系?答:PSR-15 中间件类比控制器过滤器,职责在请求前后包裹处理器。

06.5.3.4-019 路由匹配性能如何优化?

一句话结论

控制规则数量与正则复杂度,避免通配规则在前;生产环境利用 OPcache 缓存配置与规则元数据,静态资源由 Web 服务器直接命中,不进入框架入口。

概念解释

每条规则按顺序尝试,规则越多、正则越复杂,匹配成本越高。路由表在配置加载时解析一次,运行期复用;高频站点应把精确规则前置、通配规则后置。

原理流程

  1. 配置加载时构建规则列表。
  2. 请求时顺序匹配,OPcache 保证配置脚本不重复编译。
  3. 服务器层先命中静态资源,动态请求才进入入口。

代码或图示

// 规则排列:精确资源优先,通配兜底
'rules' => [
    'posts' => 'post/index',
    'post/<id:\d+>' => 'post/view',
    '<controller:\w+>/<action:\w+>' => '<controller>/<action>',
],

常见误区

  • 为每条静态资源写规则:应交给服务器静态处理,不占框架规则表。
  • 正则回溯过重:复杂嵌套正则在高并发下拖慢匹配,应简化占位符约束。

追问

  • 规则能否缓存为编译形态?答:框架在请求内复用规则实例;配置文件本身由 OPcache 缓存,是否提供独立路由缓存需对照版本文档。
  • 如何定位慢匹配?答:记录命中规则与耗时,评估规则顺序与正则复杂度,必要时拆分资源模块。

06.5.3.4-020 路由常见误区:规则顺序、正则贪婪与参数遗漏

一句话结论

高频问题集中在:宽泛规则抢先匹配、正则贪婪跨段捕获、占位符参数未传入动作、出站 URL 回退 query 形式、模块前缀缺失导致 404。

概念解释

评审规则时逐条核对 pattern 约束、route 三段、verb 与 defaults;为每条规则准备入站与出站两个用例验证。参数命名在规则、动作签名、视图链接三处保持一致。

原理流程

  1. 列出规则清单,按从具体到通用排序。
  2. 核对占位符正则与动作参数名。
  3. 用真实链接与生成 URL 双向测试。

代码或图示

// 核对清单(示意)
// pattern: post/<id:\d+>  route: post/view  verb: GET
// 入站: /post/123        → post/view?id=123
// 出站: post/view id=123 → /post/123

常见误区

  • 正则未限定边界:\w+ 误吞相邻片段,把多段路径匹配到一个参数。
  • 生成 URL 只传路由不传参数:必填占位符缺值,回退 query 形式且路径不完整。

追问

  • 线上错路由如何排查?答:打印最终解析的路由与参数,对照规则顺序确认被哪条规则抢先命中。
  • 规则变更需要注意什么?答:保留旧规则做兼容跳转,新旧规则并行一段时间再下线旧链接。