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

06.5.1.2 路由中间件与请求处理

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

本节要解决的问题

  • 路由如何定义、参数绑定与组织,API 版本化怎么落?
  • 中间件如何注册与排序,请求校验与响应封装在哪一层?
  • 认证、授权(Guard/Gate/Policy)、Sanctum/Passport 如何集成,CSRF 如何防护?

版本前提:PHP 8.2+ / Laravel 10-11;中间件与认证组件名称以对应版本文档为准。

06.5.1.2-001 路由如何定义与组织?

一句话结论

路由文件按模块注册路径、HTTP 方法与控制器动作;路由分组统一前缀、中间件与命名空间;控制器只接收请求并调用服务,路由不写业务逻辑。

概念解释

路由是请求入口的声明层:把 URL 与 HTTP 方法映射到控制器方法,分组能力把公共前缀、中间件与名称前缀收拢。路由本身只做映射,规则与流程在服务层完成。

示例

Route::get('/orders/{id}', [OrderController::class, 'show']);
Route::prefix('api')->group(function () {
    Route::get('/products', [ProductController::class, 'index']);
});

常见误区

  • 闭包路由里写业务逻辑:无法复用、难以测试。
  • 所有路由堆在一个文件:模块边界不清,路由表膨胀。

追问

  • 路由分组能携带什么?前缀、中间件、命名空间、名称前缀。
  • 404 未匹配如何兜底?最后注册兜底路由或异常处理器统一响应。

06.5.1.2-002 路由参数与模型绑定如何工作?

一句话结论

路径占位符按名传入控制器参数;类型提示模型时框架自动按主键查询并绑定,找不到模型抛 404;绑定可约束主键字段与作用域(如只查当前用户资源)。

概念解释

隐式模型绑定减少手动查询:路由参数 {order} 提示 Order $order 即自动解析。绑定作用域需注意越权:默认按主键查,不自动按归属过滤。

常见误区

  • 模型绑定后不校验归属:拿到订单 ID 即可访问他人订单(IDOR)。
  • 绑定字段与路由名不匹配:解析为空或抛异常。

追问

  • 显式绑定与隐式绑定区别?显式手动查询更可控,隐式减少样板代码。
  • 绑定失败返回什么?404 或按业务返回 403,取决于资源是否存在与归属。

06.5.1.2-003 路由命名与 URL 如何生成?

一句话结论

路由可注册名称,代码内按名称生成 URL,避免硬编码路径;重定向与视图引用命名路由;路径调整时只需改路由定义,引用处保持不变。

概念解释

命名路由解耦链接生成与路径定义。分组内名称可加前缀,避免跨模块重名。

常见误区

  • 代码里拼路径字符串:路径调整后多处漏改。
  • 路由名称冲突:同名覆盖导致生成错误链接。

追问

  • 参数如何带入生成 URL?命名路由生成时传入占位参数。
  • 外部跳转用什么?命名路由生成内部地址,外部完整 URL 仍需基础域名配置。

06.5.1.2-004 中间件如何注册与分类?

一句话结论

中间件分全局(每个请求经过)、路由分组、路由/控制器级三类;注册到内核中间件列表或路由定义中;前置处理在控制器前,后置处理在响应后。

概念解释

中间件是横切能力挂载点:认证、日志、CORS、压缩、请求限制。分类决定作用范围,顺序决定执行先后。

常见误区

  • 把只用于个别路由的中间件设为全局:无关请求额外开销。
  • 中间件顺序错乱:鉴权晚于解析或业务,拦截失效。

追问

  • 中间件别名有什么用?内核别名表把短名映射到中间件类,路由中简写引用。
  • 中间件能终止请求吗?能,前置阶段直接返回响应,不再进入后续链路。

06.5.1.2-005 控制器如何组织保持精简?

一句话结论

控制器只做:取输入、调用服务、映射响应;业务规则、事务编排、权限判定在服务与授权层;控制器方法对应一个用例,不堆跨用例逻辑。

概念解释

薄控制器让业务可被 API、队列、命令行等多入口复用。控制器依赖通过构造器注入服务。

常见误区

  • 控制器内直接操作模型与数据库:业务与 HTTP 耦合。
  • 一个控制器堆几十个动作:按资源/用例拆分。

追问

  • 控制器与表单请求如何配合?请求类校验入参,控制器只接收合法输入。
  • 响应转换放哪?控制器或响应资源类把模型转为接口结构。

06.5.1.2-006 表单请求(FormRequest)如何做参数校验?

一句话结论

表单请求类继承请求基类,rules() 定义字段校验规则,authorize() 判定权限;校验失败自动抛 422 字段错误,通过后控制器拿到已校验请求;格式校验在入口,业务规则在服务层。

概念解释

FormRequest 把校验与授权从控制器抽出,可复用、可测试。规则覆盖必填、类型、长度、正则、唯一/存在等场景。

常见误区

  • 校验规则只写在控制器:多入口重复且遗漏。
  • 用 Schema 校验跨表业务唯一性:跨状态约束应在服务层判定。

追问

  • 字段错误消息如何自定义?messages() 与属性名映射返回可读提示。
  • 嵌套数组怎么校验?规则用点号路径定义数组字段约束。

06.5.1.2-007 响应类型如何选择?

一句话结论

API 返回 JSON 资源结构,网页返回视图渲染,提交成功可重定向;响应统一包装成功/错误结构;状态码按语义选择,不全部用 200 表达失败。

概念解释

响应格式与接口契约一致:JSON API 不返回 HTML 错误页。资源类控制字段裁剪,避免直接序列化模型全部属性。

常见误区

  • 错误也返回 200 + 业务码:HTTP 语义被忽略,网关与监控无法按状态码识别。
  • 模型直接 toJson:内部字段与关联结构全量泄漏。

追问

  • 分页响应结构?列表数据 + 分页元信息(总数、页码、页大小)。
  • 文件下载怎么响应?专用流式响应,不经过 JSON 包装。

06.5.1.2-008 异常如何映射为 HTTP 响应?

一句话结论

异常处理器按类型渲染:认证失败 401、无权限 403、不存在 404、冲突 409、参数校验 422、内部错误 500;记录完整堆栈到服务端,对外只返回错误码与可读提示。

概念解释

业务抛领域异常,处理器统一转响应。未捕获异常在生产环境屏蔽细节,开发环境展示调试信息。

常见误区

  • 控制器内 catch 所有异常返回通用 500:丢失错误语义与日志分类。
  • 生产开启调试页面:泄漏环境、路径与配置信息。

追问

  • 校验异常谁抛出?表单请求校验失败由框架抛 HTTP 异常,处理器渲染字段错误。
  • 下游依赖失败怎么归类?包装为内部错误或降级业务错误,保留 cause 供日志。

06.5.1.2-009 内置认证(Auth)如何工作?

一句话结论

Guard 按驱动(Session/Token)解析当前用户,auth() 提供用户与判定方法;auth 中间件保护路由,未认证抛 401;用户对象由 Guard 解析后放入请求上下文。

概念解释

认证回答"当前是谁"。不同 Guard 对应不同凭证来源:Web 会话、API Token。登录成功后 Guard 建立用户身份。

常见误区

  • 业务代码自己读请求头找用户:绕过 Guard,身份不可信。
  • 认证中间件漏挂:接口匿名可访问。

追问

  • 用户对象从哪里取?auth()->user(),下游不重复解析凭证。
  • 多 Guard 如何指定?路由中间件声明 Guard,按会话/Token 分别解析。

06.5.1.2-010 Gate 与 Policy 如何做授权?

一句话结论

Gate 用闭包定义权限判定,Policy 按模型组织授权类;控制器方法 authorize 判定当前用户能否操作资源;授权在认证之后,校验资源归属与角色权限。

概念解释

授权回答"能不能做这件事"。Policy 把某模型的全部权限动作集中到一个类,Gate 适合简单跨资源判定。

常见误区

  • 只在前端隐藏按钮:后端不授权,越权仍可直接调接口。
  • Policy 只判角色不判归属:同角色可访问他人资源。

追问

  • Policy 如何注册?按模型类映射到 Policy 类,容器自动解析。
  • 授权失败返回什么?403,不向未授权者暴露资源是否存在。

06.5.1.2-011 Sanctum 与 Passport 有什么区别?

一句话结论

Sanctum 提供轻量 Token 与会 SPA 认证,配置简单,适合自家前后端与简单 API;Passport 实现 OAuth2 服务端,适合开放第三方授权场景;按协议复杂度与生态需求选择。

概念解释

两者都解决 API 认证:Sanctum 偏实用 Token 方案,Passport 偏标准 OAuth2 流程。不要为简单内部接口引入整套 OAuth2 复杂度。

常见误区

  • 内部服务调用上 Passport:OAuth2 流程成本与收益不匹配。
  • 只存 Token 不做撤销机制:登出/改密后旧 Token 仍可用。

追问

  • Token 如何失效?Sanctum 可撤销 Token 记录;过期与轮换策略按业务设定。
  • SPA 会话与 API Token 能否混用?按 Guard 分开,凭证来源不同。

06.5.1.2-012 多守卫(multi Guard)如何配置?

一句话结论

不同入口(用户 Web、管理后台、API)使用不同 Guard,各自用户表/凭证驱动;路由按中间件指定 Guard;身份对象按 Guard 解析,避免会话与 Token 体系混用。

概念解释

多守卫隔离不同身份域:管理员与普通用户即使同库也可分 Guard 与权限策略。守卫配置声明用户提供方与驱动。

常见误区

  • 管理接口挂用户 Guard:后台身份与权限体系混用。
  • 一个 Guard 内塞多种凭证来源:判定逻辑混乱。

追问

  • 跨守卫能否共享用户模型?可共享表,但 Guard 与授权策略分开配置。
  • 默认 Guard 在哪配置?认证配置文件声明默认驱动,路由可覆盖。

06.5.1.2-013 CSRF 防护如何工作?

一句话结论

Session/Web 表单场景校验 CSRF Token,中间件比对会话令牌与请求携带令牌;Cookie 携带会话时浏览器自动发起跨站请求无法伪造 Token;纯 Token API 不走 Cookie 时风险较低。

概念解释

CSRF 防护依赖"跨站读不到页面内 Token"。Token 随表单或 Header 提交,服务端与会话比对。

常见误区

  • API 只靠 Bearer Token 却开 CSRF 校验:Header 不自动携带,请求被误拦。
  • Token 固定不变且长期暴露:应随会话刷新。

追问

  • 哪些请求需要 CSRF 校验?改变状态的 POST/PUT/DELETE,GET 只读不参与。
  • 豁免路由怎么处理?按可信入口白名单配置,不整站关闭防护。

06.5.1.2-014 路由模型绑定如何避免 404 与越权混淆?

一句话结论

先按主键判断资源是否存在(404),再校验归属与权限(403);模型绑定只解决存在性,归属判定在 Policy/服务层;对未授权访问不暴露资源细节。

概念解释

存在性与权限是两层:资源不存在返回 404,存在但无权访问返回 403。模糊处理会泄漏"该 ID 存在"的信息。

常见误区

  • 绑定失败一律 403:帮助攻击者枚举有效 ID。
  • 绑定后跳过 Policy:越权访问他人资源。

追问

  • 列表查询如何防越权?查询条件强制带当前用户/组织归属,不靠前端传范围。
  • 软删除资源绑定怎么处理?默认排除删除标记,需显式包含。

06.5.1.2-015 输入过滤与批量赋值(mass assignment)如何防?

一句话结论

请求只取允许字段,模型 fillable 声明可批量赋值属性;禁止把整个请求输入直接塞进模型;多余字段在入口丢弃,防篡改角色、状态等敏感列。

概念解释

批量赋值漏洞来自客户端传入未预期字段。白名单字段清单在模型层声明,请求层再按 DTO 约束。

常见误区

  • $model->fill($request->all()):客户端可传 role、status 等字段被写入。
  • guarded 留空全开放:等于无白名单。

追问

  • 敏感字段如何更新?控制器显式赋值并经过授权与业务校验。
  • 字段白名单放哪?模型 fillable,接口 DTO 再做一层入口约束。

06.5.1.2-016 中间件的前置、后置与终止阶段如何使用?

一句话结论

handle 中 $next($request) 之前是前置逻辑,之后是后置响应处理;terminate 在响应发送后执行收尾(如慢日志统计);中间件可包裹异常与计时。

概念解释

洋葱结构让同一中间件同时处理进出两个方向。终止阶段不影响响应内容,用于资源收尾。

常见误区

  • 后置逻辑在读请求 body:body 已被下游消费或重写。
  • terminate 里做必须完成的业务写入:进程可能在收尾阶段被切断。

追问

  • 计时日志放哪?前置记录开始时间,后置计算耗时写指标。
  • 中间件异常如何传递?抛出异常进入异常处理器,后置逻辑按 try/finally 保证执行。

06.5.1.2-017 API 版本化路由如何组织?

一句话结论

版本号放路径前缀、Header 或媒体类型,团队约定统一;新旧版本路由分组并存,版本间共享服务层;破坏性变更走新版本,旧版本公告周期后下线。

概念解释

版本化保证老客户端不被新接口破坏。服务层不按版本分叉,版本差异在控制器与响应资源层处理。

常见误区

  • 直接改旧接口字段语义:未升级客户端故障。
  • 版本逻辑复制到控制器:同一业务多处维护。

追问

  • 版本放路径优缺点?直观可见,路径变长;Header 方式路径干净但调试不便。
  • 旧版本下线流程?公告废弃周期,统计调用量后摘除路由。

06.5.1.2-018 路由缓存对部署有什么要求?

一句话结论

生产可缓存路由定义减少注册解析;路由文件变更后需重建缓存;开发环境不开缓存避免改动不生效;缓存产物随部署流程生成,不手工改缓存文件。

概念解释

路由缓存把路由表编译固化,提升引导性能。新增/修改路由后缓存未重建会出现路由不生效。

常见误区

  • 部署后忘记重建路由缓存:新接口 404 或旧路由残留。
  • 在开发环境依赖缓存:调试改动不反映。

追问

  • 路由缓存能包含闭包吗?缓存编译有约束,复杂定义需按框架限制调整(以版本文档为准)。
  • 缓存产物放哪里?框架 storage 目录,属生成物不手工编辑。