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 目录,属生成物不手工编辑。