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

06.5.4.4 中间件与 Pipeline 管道

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

覆盖范围

  • Pipeline 的 array_reduce 实现与闭包穿透
  • 前置/后置中间件、优先级与短路
  • 中间件别名、分组、终止阶段与自定义管道

基础概念见 06.5.1.2 路由中间件与请求处理;本页聚焦 Pipeline 机制纵深。

06.5.4.4-001 Pipeline 如何用 array_reduce 串起一串中间件?

一句话结论

Pipeline 把中间件数组用 array_reduce 从后往前折叠成一个嵌套闭包:每层闭包持有下一层调用,最内层是最终目标(控制器/闭包),请求进入后沿嵌套闭包逐层向外执行。

概念解释

折叠方向决定执行链:先构造“最后一个中间件包裹目标”,再逐个往前包裹。array_reduce 的累加值是当前已组装的闭包,新中间件把它作为 $next 接收。

原理流程

  1. 传入 traveler(请求)、pipes(中间件数组)、destination(目标闭包)。
  2. array_reduce 从最后一个 pipe 开始,逐个生成“当前 pipe + 下一层闭包”。
  3. 组装完成后调用最外层闭包,传入 traveler。
  4. 每层执行前置逻辑 → 调用 $next → 执行后置逻辑。

代码或图示

// 等价示意:array_reduce 折叠为嵌套闭包(源码以 Illuminate\Pipeline\Pipeline 为准)
$pipes = [AuthMiddleware::class, LogMiddleware::class];
$stack = array_reduce(
    array_reverse($pipes),
    fn ($next, $pipe) => fn ($passable) => $app->call($pipe, ['passable' => $passable, 'next' => $next]),
    $destination
);

常见误区

  • 以为中间件按数组顺序从左到右包裹:折叠从尾端开始,数组顺序最终对应外层到内层的执行顺序。
  • 把 Pipeline 当成队列串行执行:嵌套闭包是洋葱模型,后置逻辑在 $next 返回后执行。

追问

  • array_reduce 的初始值是什么?答:是最终目标闭包(destination),即管道最内层要执行的控制器或业务闭包。
  • Pipeline 容器参数起什么作用?答:容器用于解析中间件类并调用其 handle/invoke 方法,中间件依赖由容器注入。

06.5.4.4-002 中间件闭包穿透($next)的执行模型是什么?

一句话结论

每个中间件收到 $request 与 $next 闭包,调用 $next($request) 把请求传给下一层;返回值是后续管道产出的 Response,中间件可在返回前后加工请求与响应。

概念解释

$next 是闭包穿透点:不调用 $next 即短路,后续层与目标都不执行;调用后控制权进入内层,内层响应返回后回到当前层继续后置逻辑。

原理流程

  1. 外层中间件执行前置逻辑(鉴权、日志开始)。
  2. 调用 $next($request) 进入下一层。
  3. 内层完成处理并返回 Response。
  4. 外层拿到 Response,执行后置逻辑后继续返回。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    $start = microtime(true);
    $response = $next($request);      // 穿透到下一层
    $response->header('X-Elapsed', (string) (microtime(true) - $start));
    return $response;
}

常见误区

  • 忘记 return $next($request):后续管道响应丢失,返回 null。
  • 在 $next 之后修改请求对象:内层已消费请求,后置阶段改请求不影响已执行逻辑。

追问

  • $next 闭包接收什么参数?答:当前 passable(HTTP 中间件为 Request),返回值为 Response;非 HTTP 管道的 passable 类型由管道用途决定。
  • 中间件可以返回其他类型吗?答:HTTP 管道最终需归约为 Response;返回数组/字符串由目标层或响应工厂包装,具体以内核处理为准。

06.5.4.4-003 前置与后置中间件如何区分执行位置?

一句话结论

$next($request) 之前的代码是前置逻辑(请求到达目标前执行),之后的代码是后置逻辑(响应返回后执行);同一中间件可同时包含前后两段。

概念解释

洋葱模型下,前置按中间件栈顺序由外到内,后置按相反顺序由内到外。鉴权、限流、请求改写通常前置;日志计时、响应头、响应体改写通常后置。

原理流程

  1. 前置段:校验/加工请求,决定是否放行。
  2. 调用 $next 进入内层。
  3. 内层返回 Response。
  4. 后置段:加工响应、记录耗时、补充响应头。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    // 前置:请求到达前
    $token = $request->bearerToken();

    $response = $next($request);

    // 后置:响应返回后
    $response->setStatusCode($response->getStatusCode());
    return $response;
}

常见误区

  • 把后置校验写在 $next 之后:请求已到达目标,越权/非法输入可能已被处理。
  • 以为后置中间件一定能改响应体:流式响应、已发送响应受输出缓冲限制,需按响应类型处理。

追问

  • 后置顺序与前置一致吗?答:相反,外层最后后置、内层最先后置;日志计时应放在外层以覆盖全链路。
  • terminable 中间件与后置段区别?答:后置段在响应返回前执行;terminate 在响应发送给客户端后执行,见本页后续题。

06.5.4.4-004 中间件优先级(priority)如何控制全局与路由中间件顺序?

一句话结论

框架维护中间件优先级清单,规定哪些中间件必须排在前后;全局中间件、路由中间件按优先级与注册顺序组装,优先级高的先进入管道外层。

概念解释

部分中间件有强先后依赖(如 session 必须在 CSRF 之前、认证需在会话就绪后)。优先级定义在 HTTP Kernel 的中间件排序配置中;同优先级内按注册顺序排列。

原理流程

  1. 内核收集全局中间件与路由挂载中间件。
  2. 按优先级清单排序,未列出的按注册顺序追加。
  3. 组装 Pipeline 栈。
  4. 请求按最终栈顺序穿透。

代码或图示

// Kernel 中优先级清单(结构以当前版本为准)
protected $middlewarePriority = [
    \Illuminate\Cookie\Middleware\EncryptCookies::class,
    \Illuminate\Session\Middleware\StartSession::class,
    \Illuminate\Auth\Middleware\Authenticate::class,
];

常见误区

  • 以为路由内 middleware 数组顺序就是最终顺序:优先级清单会重排,数组顺序只在同优先级内生效。
  • 自定义有先后依赖的中间件不进优先级清单:顺序不确定,可能出现会话未就绪就读用户。

追问

  • 如何查看最终中间件栈?答:路由列表命令(route:list)展示路由中间件;调试时可在各中间件打点记录进入顺序。
  • 全局与路由中间件谁先执行?答:全局中间件先进入栈(外层),路由中间件在内层;具体顺序仍受优先级清单影响。

06.5.4.4-005 中间件如何短路请求并直接返回响应?

一句话结论

中间件不调用 $next,直接返回 Response(如重定向、错误 JSON、限流响应),后续中间件与控制器都不再执行,管道在此终止。

概念解释

短路是前置中间件的核心能力:鉴权失败、限流命中、请求不合法时立即响应。短路点在外层可节省后续层与目标的执行成本。

原理流程

  1. 中间件前置校验失败。
  2. 构造响应(重定向、401/429/400 JSON)。
  3. 不调用 $next,直接 return 响应。
  4. Pipeline 把该响应向上返回,跳过内层。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    if (! $request->user()?->isAdmin()) {
        return response()->json(['message' => 'forbidden'], 403);
    }
    return $next($request);
}

常见误区

  • 短路后仍执行 $next:内层被调用,短路失效。
  • 短路响应未经过后置中间件:未被穿透的外层后置段不执行,日志/计时可能遗漏,需在短路点自行记录。

追问

  • 抛异常与短路返回区别?答:抛异常由异常处理器统一映射响应;直接返回响应跳过异常处理链。鉴权失败通常走异常/重定向约定。
  • 短路能阻止后置中间件吗?答:未进入的层不执行;已在外层执行过前置的中间件其后置段是否运行取决于管道归约实现,需以源码为准。

06.5.4.4-006 后置阶段如何改写响应内容?

一句话结论

后置段拿到 $next 返回的 Response,可修改响应头、状态码与内容体(如注入调试信息、压缩、CORS 头),再把加工后的响应继续返回。

概念解释

Response 对象在管道内逐层传递,后置中间件读取并修改它。对 JSON 响应改头部较安全;改写内容体需注意编码、分片与原始响应类型。

原理流程

  1. 内层返回 Response 实例。
  2. 后置中间件读取响应头/内容。
  3. 调用响应对象方法加工(header、setContent、withCookie)。
  4. 返回加工后的响应给外层。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    $response = $next($request);
    $response->headers->set('X-App-Version', '1.0');
    $content = $response->getContent();
    $response->setContent($content . "\n<!-- debug -->");
    return $response;
}

常见误区

  • 对二进制/下载响应改内容体:破坏文件字节,应只改头部。
  • 后置段直接 echo 输出:绕过 Response 对象,后续缓存与发送流程异常。

追问

  • 响应内容为空怎么办?答:先判断响应类型(文件流、JSON、视图),只对可控 HTML/JSON 做内容改写。
  • CORS 头在哪一层加?答:通常由专门的 CORS 中间件后置统一补充,需对预检请求单独放行。

06.5.4.4-007 Pipeline 的 via() 方法指定什么?

一句话结论

via($method) 指定调用中间件时使用的方法名,HTTP 中间件默认 handle;自定义管道可用其他方法名(如 invoke 或业务方法),Pipeline 按该方法签名解析参数并调用。

概念解释

Pipeline 不固定中间件协议,via 决定方法入口。中间件类通过该方法接收 passable 与 next 闭包,容器解析方法参数。

原理流程

  1. 构造 Pipeline,send($passable) 传入初始对象。
  2. through($pipes) 注册中间件列表。
  3. via('handle') 指定调用方法。
  4. then(Closure) 提供最终目标,归约执行。

代码或图示

$response = (new Pipeline(app()))
    ->send($request)
    ->through([AuthMiddleware::class, LogMiddleware::class])
    ->via('handle')
    ->then(fn (Request $request) => $this->dispatch($request));

常见误区

  • 自定义中间件方法名与 via 不一致:调用未定义方法报错。
  • 方法签名缺少 next 参数:管道闭包无法传入,归约失败。

追问

  • 可调用闭包作为 pipe 吗?答:可以,闭包直接接收 passable 与 next,不走方法名解析;具体类型判断以 Pipeline 源码为准。
  • via 方法参数如何注入?答:容器按方法签名解析 passable、next 与类型提示依赖。

06.5.4.4-008 中间件别名与组中间件如何注册?

一句话结论

别名把中间件类名映射为短名(如 auth、throttle),组中间件把一组别名打包;别名在 HTTP Kernel 的 $middlewareAliases(旧版 $routeMiddleware)注册,组在 $middlewareGroups 配置。

概念解释

路由定义用短名引用中间件,避免写完整类名。组中间件一次挂载整组(web/api),组内元素可含别名与类名。

原理流程

  1. 在 Kernel 别名表登记短名 → 中间件类。
  2. 在组配置中把别名归入 web/api 等组。
  3. 路由 middleware('auth') 或 middleware('web') 引用。
  4. 内核解析短名/组为中间件类栈。

代码或图示

protected $middlewareAliases = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
];

protected $middlewareGroups = [
    'web' => [EncryptCookies::class, StartSession::class, Authenticate::class],
];

常见误区

  • 只在路由用别名不在 Kernel 注册:路由解析不到短名,抛中间件未定义错误。
  • 组内重复挂载同一中间件:可能重复执行鉴权/计数。

追问

  • Laravel 11 中间件注册位置有变化吗?答:新版本可在 bootstrap/app.php 的中间件配置中登记别名与组;具体写法以当前版本升级文档为准,属待确认项。
  • 别名能带默认参数吗?答:路由引用时传参(如 throttle:60,1),别名本身映射类。

06.5.4.4-009 terminable 中间件在响应发送后执行什么?

一句话结论

实现终止接口并定义 terminate(Request $request, Response $response) 的中间件,在响应发送给客户端后继续执行收尾逻辑(如记录访问日志、上报耗时),不阻塞响应返回。

概念解释

terminate 是请求生命周期的最后阶段:内核发送响应后遍历可终止中间件调用 terminate。适合慢收尾操作,避免拉长用户等待时间。

原理流程

  1. 中间件 handle 正常穿透管道返回响应。
  2. 内核发送响应到客户端。
  3. 收集实现终止接口的中间件实例。
  4. 逐个调用 terminate($request, $response) 执行收尾。

代码或图示

class AccessLogMiddleware implements TerminableMiddleware
{
    public function handle(Request $request, Closure $next): Response
    {
        return $next($request);
    }

    public function terminate(Request $request, Response $response): void
    {
        // 响应发送后记录日志/上报指标
    }
}

常见误区

  • 在 terminate 中依赖尚未保存的请求状态:请求对象仍可用,但响应已发出,不能再改响应。
  • 以为 terminate 在 FPM 进程回收前必然完整执行:SAPI 终止阶段行为受进程管理与超时影响,长任务应放队列。

追问

  • terminate 与后置段区别?答:后置段在响应返回客户端前、管道内执行;terminate 在响应发送后由内核单独遍历调用。
  • 终止方法抛异常影响响应吗?答:响应已发送,异常只影响收尾逻辑;需自行记录日志,避免中断后续终止中间件。

06.5.4.4-010 中间件参数如何从路由定义传入?

一句话结论

路由 middleware('throttle:60,1') 中冒号后内容作为参数传入中间件 handle 方法,排在 $next 之后;中间件按形参顺序接收并使用。

概念解释

参数化中间件复用同一类实现不同配置:限流阈值、角色名、通道名等通过路由参数传入。参数在路由解析时拆分注入方法签名。

原理流程

  1. 路由定义短名 + 冒号 + 逗号分隔参数。
  2. 内核解析中间件类与参数列表。
  3. 调用 handle 时在 passable、next 之后依次传入参数。
  4. 中间件按形参类型与顺序使用参数。

代码或图示

// 路由
Route::get('/reports', fn () => [])->middleware('role:editor,admin');

// 中间件 handle
public function handle(Request $request, Closure $next, string ...$roles): Response
{
    abort_unless($request->user()?->hasRole($roles), 403);
    return $next($request);
}

常见误区

  • 参数写在 next 之前:管道按固定顺序传参,形参位置错误导致类型不符。
  • 参数数量与形参不匹配:多余参数忽略或报参数错误,以框架调用实现为准。

追问

  • 参数可以是数组吗?答:逗号分隔字符串在方法内拆分;可变参数形参接收多个值。
  • 全局中间件能带参数吗?答:全局栈通常无路由参数;参数化中间件主要挂在路由/组级别。

06.5.4.4-011 全局、路由、控制器中间件的挂载层级与顺序是什么?

一句话结论

全局中间件对所有请求生效,先进入管道外层;路由中间件按路由/组挂载在内层;控制器中间件挂在控制器类或动作上,位置随路由解析进入栈。最终顺序再经优先级清单重排。

概念解释

三层挂载对应不同复用范围:全局处理 CORS、加密 Cookie、会话;路由处理鉴权、限流;控制器中间件处理单控制器特定约束。

原理流程

  1. 内核先组装全局中间件栈。
  2. 路由匹配后追加路由/组中间件。
  3. 控制器注解或属性挂载的中间件加入栈。
  4. 优先级排序后归约为 Pipeline。

代码或图示

// 全局:Kernel $middleware
// 路由组:Route::middleware('web')->group(...)
// 控制器构造/属性中挂载
class ReportController extends Controller
{
    public function __construct()
    {
        $this->middleware('permission:view-report');
    }
}

常见误区

  • 把只保护个别路由的中间件挂全局:扩大执行面,性能与副作用范围失控。
  • 以为控制器中间件最内层执行:其栈位置由挂载层级与优先级共同决定。

追问

  • 控制器中间件如何限定动作?答:可通过 only/except 选项或方法名白名单限定,具体 API 以当前版本基类为准。
  • 如何核对某路由的完整中间件?答:用路由列表命令查看该路由挂载的别名与组。

06.5.4.4-012 中间件中抛出异常如何穿过管道?

一句话结论

异常在中间件或目标抛出后不再沿正常 $next 返回路径传播,而是向上冒泡出 Pipeline,由框架异常处理器捕获并映射为 HTTP 响应;未被穿透的后置中间件不会再执行。

概念解释

洋葱模型的异常路径与正常返回不同:内层抛异常直接跳出嵌套闭包,外层后置段若未用 try/catch 包裹则不执行。异常处理器在管道外层统一接管。

原理流程

  1. 某层中间件或控制器抛出 Throwable。
  2. 异常沿调用栈跳出嵌套闭包。
  3. Pipeline 不再执行后续正常返回逻辑。
  4. 内核异常处理器捕获,生成错误响应。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    try {
        return $next($request);
    } catch (BusinessException $e) {
        report($e);
        throw $e; // 继续冒泡由异常处理器映射
    }
}

常见误区

  • 依赖后置中间件做异常清理:异常路径下后置段可能不运行,资源释放应放 try/finally。
  • 在中间件吞掉异常不转抛:错误被掩盖,异常处理器收不到对应状态码。

追问

  • 如何记录所有异常耗时?答:在外层中间件 try/catch 记录后重抛,或依赖全局异常处理器与日志。
  • 异常处理器在管道内还是管道外?答:在 HTTP 内核调用管道的外层,属于框架统一错误处理层。

06.5.4.4-013 如何用 Pipeline 独立执行一段非 HTTP 自定义管道?

一句话结论

实例化 Pipeline 传入容器,send 自定义 passable 对象,through 业务处理类/闭包,then 提供收尾闭包,即可把同一洋葱模型复用于数据加工、校验链、任务处理等非 HTTP 场景。

概念解释

Pipeline 与 Request/Response 解耦:passable 可以是任意对象或数组。非 HTTP 管道适合组织多层处理步骤(过滤、转换、 enrichment、校验)。

原理流程

  1. 构造 Pipeline 并注入容器。
  2. send 传入待处理数据对象。
  3. through 注册处理步骤类或闭包。
  4. then 定义最终输出闭包,返回处理结果。

代码或图示

$result = (new Pipeline(app()))
    ->send($payload)
    ->through([ValidatePayload::class, EnrichData::class, NormalizeOutput::class])
    ->via('process')
    ->then(fn (array $data) => $data);

常见误区

  • 自定义步骤类仍写 handle(Request, Closure):passable 类型不匹配,应按管道数据类型定义方法签名。
  • 管道目标闭包未返回最终结果:归约值为 null,后续业务取不到数据。

追问

  • 非 HTTP 管道需要容器吗?答:步骤类有依赖时需要容器解析;纯闭包管道可直接组装,容器为可选注入。
  • 步骤间共享状态怎么传?答:通过 passable 对象属性或返回值闭包传递;避免使用全局静态变量。

06.5.4.4-014 中间件如何向请求写入共享状态?

一句话结论

中间件在前置段把解析出的用户、上下文、标识等挂到 Request 对象属性或请求宏上,内层中间件与控制器读取同一 Request 实例;Pipeline 传递的是同一引用。

概念解释

请求对象在管道内逐层传递同一引用,外层写入的属性内层可读。共享状态应明确命名,避免覆盖框架已有属性;跨请求状态不能放中间件实例属性。

原理流程

  1. 外层中间件解析上下文并写入 Request。
  2. 调用 $next($request) 传递同一引用。
  3. 内层从 Request 读取共享状态。
  4. 请求结束对象随请求销毁。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    $request->merge(['tenant_id' => $this->resolveTenant($request)]);
    return $next($request);
}

常见误区

  • 把共享状态存中间件类属性:中间件实例在 FPM 下每请求重建,常驻模式下可能跨请求残留。
  • 内层直接修改外层写入的敏感字段:应通过明确方法或属性约定读写。

追问

  • Request 宏(macro)用于什么?答:给请求对象补充自定义方法,封装状态读取逻辑;宏注册在提供者中完成。
  • 队列任务能复用请求状态吗?答:不能,请求对象不跨任务传递;需要的数据应显式序列化进任务属性。

06.5.4.4-015 中间件依赖注入在构造器还是 handle 方法?

一句话结论

中间件可通过构造函数声明协作依赖(容器解析中间件实例时注入),Request 与 next 闭包在 handle 方法签名中接收;重依赖走构造器,请求级对象走方法参数。

概念解释

中间件实例由容器解析,构造器注入与控制器服务一致。方法签名中的 passable、next 由 Pipeline 传入,类型提示的其他依赖也可在方法参数解析。

原理流程

  1. 中间件类构造函数声明服务依赖。
  2. 容器解析中间件实例时注入构造依赖。
  3. Pipeline 调用 handle,传入 Request 与 next。
  4. 方法内使用构造依赖与请求参数。

代码或图示

class AuditMiddleware
{
    public function __construct(private readonly AuditLogger $logger) {}

    public function handle(Request $request, Closure $next): Response
    {
        $this->logger->log($request->path());
        return $next($request);
    }
}

常见误区

  • 在构造器读取请求用户:中间件实例化时机可能早于请求就绪,请求对象应在 handle 获取。
  • 构造器注入请求级单例:常驻模式下状态残留风险同服务容器规则。

追问

  • handle 方法能再注入其他服务吗?答:可以,方法类型提示参数由容器解析;与构造注入的取舍按依赖生命周期决定。
  • 中间件实例复用吗?答:FPM 下每请求解析;常驻模式下复用行为需结合运行时确认,避免实例属性保存请求状态。

06.5.4.4-016 路由中间件组与 middleware: 栈的组装顺序是什么?

一句话结论

路由组嵌套时中间件按外层组到内层组的顺序叠加,控制器/动作中间件最后加入;同名组可在父组与子组重复出现,最终栈去重规则与顺序以内核实现为准。

概念解释

Route::group 嵌套会合并中间件配置:父组中间件在外层,子组在内层。路由文件中 middleware 调用多次时,按调用顺序追加到当前组栈。

原理流程

  1. 父路由组声明中间件组。
  2. 嵌套子组追加自身中间件。
  3. 具体路由追加动作级中间件。
  4. 内核解析别名/组为类栈,优先级重排后组装。

代码或图示

Route::middleware('web')->group(function () {
    Route::middleware('auth')->group(function () {
        Route::get('/profile', [ProfileController::class, 'show'])
            ->middleware('permission:read-profile');
    });
});

常见误区

  • 以为子组中间件先执行:父组外层先进入管道,子组在内层。
  • 重复挂载全局已有的中间件:可能二次计数或二次鉴权,需核对最终栈。

追问

  • 如何查看嵌套组最终中间件?答:路由列表命令展示合并后的中间件字符串;调试打点记录实际进入顺序。
  • 组中间件可以移除吗?答:路由层一般只追加不移除;需要差异化时拆分组定义,移除父组中间件的机制以版本源码为准。

06.5.4.4-017 返回 $next($request) 与直接返回 Response 有什么区别?

一句话结论

$next($request) 把请求交给后续管道并取得目标响应;直接返回 Response 跳过后续层与目标,用于短路拦截。两者返回类型都是 Response,但执行链路范围不同。

概念解释

handle 的返回值成为外层收到的响应。穿透返回的是内层产物;短路返回的是当前层构造的响应。未调用 $next 时内层不执行。

原理流程

  1. 穿透:调用 $next,内层处理,响应逐层回传。
  2. 短路:当前层构造响应,直接 return。
  3. 外层把收到的响应继续向上传递。
  4. 最终响应由内核发送。

代码或图示

// 穿透
return $next($request);

// 短路
return response()->json(['error' => 'unauthorized'], 401);

常见误区

  • 调用 $next 后又忽略其返回值:内层响应丢失,返回 null 导致后续错误。
  • 短路响应忘记设置状态码:默认 200,拦截语义不正确。

追问

  • 可以修改 $next 返回的响应后再返回吗?答:可以,后置加工正是此模式;修改后需 return 加工后的 Response。
  • 中间件返回视图/字符串可以吗?答:最终由内核响应工厂转换;规范做法是返回 Response 实例。

06.5.4.4-018 中间件终止逻辑与 terminate() 方法签名是什么?

一句话结论

可终止中间件实现框架的 terminable 接口,terminate(Request $request, Response $response) 在响应发送后被内核调用,签名固定为请求与响应两个参数,无返回值。

概念解释

terminate 用于收尾上报,不能再修改响应。方法在中间件实例上调用,实例与 handle 阶段为同一对象(FPM 生命周期内)。

原理流程

  1. handle 完成请求处理并返回响应。
  2. 内核发送响应。
  3. 内核收集终止中间件实例。
  4. 调用 terminate($request, $response),执行日志/指标上报。

代码或图示

use Illuminate\Contracts\Foundation\Application;
use Illuminate\Contracts\Http\Kernel;

public function terminate(Request $request, Response $response): void
{
    $duration = microtime(true) - ($request->server('REQUEST_TIME_FLOAT') ?? microtime(true));
    // 上报耗时与状态码
}

常见误区

  • terminate 中输出内容:响应已发送,输出可能丢失或破坏后续输出。
  • terminate 做长耗时计算:受 SAPI 终止阶段限制,应改队列异步处理。

追问

  • 如何注册终止中间件?答:实现对应契约接口后随中间件栈生效;内核在终止阶段按接口识别,无需单独登记。
  • 队列任务有 terminate 钩子吗?答:队列任务有自身生命周期(重试、失败回调),与 HTTP 终止中间件不是同一机制。

06.5.4.4-019 同一中间件在栈中重复挂载会怎样?

一句话结论

重复挂载的中间件类会在栈中出现多次,前置/后置逻辑与参数可能重复执行(如重复鉴权、重复限流计数、重复写日志);是否去重取决于内核组装实现,不能依赖自动去重。

概念解释

全局、组、路由多层叠加容易重复同一中间件。重复执行的副作用不同:无状态校验多一次成本,有计数/写副作用的中间件会产生错误数据。

原理流程

  1. 各挂载层级收集中间件条目。
  2. 内核合并为最终栈,类名重复条目保留(去重行为以源码为准)。
  3. 请求穿透时每出现一次执行一次。
  4. 计数类副作用被累加多次。

代码或图示

// 风险:auth 同时在 web 组与路由上挂载
Route::middleware('web', 'auth')->group(function () {
    // web 组内可能已含 auth
});

常见误区

  • 以为框架自动按类名去重:注册顺序与别名映射不同可能视为不同条目。
  • 重复的限流中间件导致计数翻倍:用户被过早限流,需核对最终栈。

追问

  • 如何排查重复中间件?答:在 handle 入口打点记录类名与参数,对比出现次数;结合路由列表中间件字符串定位来源组。
  • 去重应该在哪一层做?答:路由定义阶段整理,避免依赖内核隐式行为;父组已有的不要在子组重复挂。

06.5.4.4-020 如何排查中间件未生效(别名未注册/顺序错误)?

一句话结论

按“别名是否注册 → 路由是否挂载 → 最终栈顺序 → 中间件内部逻辑”四层排查:先核对 Kernel 别名表,再看路由列表中间件,打点记录进入顺序,最后检查 handle 内条件与短路分支。

概念解释

未生效常见原因:别名未登记、中间件挂错组、优先级重排导致时序错误、条件判断提前短路、抛异常被处理器接管。分层定位避免反复改代码。

原理流程

  1. 检索 Kernel/应用配置中的别名映射。
  2. route:list 核对目标路由挂载的中间件。
  3. 在各中间件 handle/terminate 打点,记录执行顺序与参数。
  4. 检查内部条件、异常捕获与响应分支。

代码或图示

public function handle(Request $request, Closure $next): Response
{
    logger()->debug('middleware hit', ['mw' => static::class, 'path' => $request->path()]);
    return $next($request);
}

常见误区

  • 只看路由文件挂载:别名未注册时中间件根本不实例化。
  • 顺序问题归因于数组书写顺序:优先级清单可能重排,需按实际打点顺序判断。

追问

  • 中间件类未被自动加载怎么办?答:核对命名空间与 composer dump-autoload;类未找到会在解析中间件时报错。
  • 生产环境如何临时排查?答:用受控日志打点记录中间件名与路径,确认后移除;避免在中间件中输出敏感请求数据。