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

06.5.2.5 中间件与请求处理链

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

本节要解决的问题

  • 中间件分哪几组、执行顺序如何,handle 与洋葱模型怎样工作?
  • 全局/应用/路由/控制器中间件分别在哪里注册,如何传参与排除?
  • 内置中间件、跨域与限流如何落地,短路返回与异常接管如何处理?

版本前提:ThinkPHP 6.x / 8.0;内置中间件类名来自官方手册,扩展包(如 CORS)按 Composer 安装。

06.5.2.5-001 中间件在请求链中起什么作用?

一句话结论

中间件包裹控制器执行,处理鉴权、跨域、Session 初始化、请求缓存、日志等横切关注点;前置逻辑在控制器前运行,后置逻辑在响应返回后运行,整体呈洋葱嵌套。

概念解释

中间件把通用拦截与装饰逻辑从业务控制器中剥离。每个中间件决定是否放行到下一层,以及如何加工请求与响应。

原理流程

  1. 请求进入中间件链,按分组顺序逐层调用。
  2. 前置逻辑处理请求后调用 $next($request) 进入下一层。
  3. 最内层到达控制器,产出响应。
  4. 响应沿链反向穿过各中间件后置逻辑后发送。

代码或图示

public function handle($request, \Closure $next)
{
    // 前置:控制器执行前
    $response = $next($request);
    // 后置:控制器执行后
    return $response;
}

常见误区

  • 中间件里写业务规则:应下沉到 Service,中间件只做准入与横切。
  • 后置逻辑写在 $next 之前:实际执行顺序与预期相反。

追问

  • 中间件与过滤器/钩子区别?答:中间件显式组成请求链,可控制放行与响应装饰;行为钩子更偏事件订阅。
  • 横切能力为什么不放控制器基类?答:基类继承耦合,中间件可按路由/分组灵活挂载与排序。

06.5.2.5-002 中间件分哪几组,执行顺序是什么?

一句话结论

分为全局中间件、应用中间件(多应用有效)、路由中间件、控制器中间件四组;执行顺序为全局 → 应用 → 路由 → 控制器。

概念解释

分组对应不同挂载层级:全局对所有请求生效,应用级隔离多应用,路由级按规则挂载,控制器级限定类内动作。

原理流程

  1. 全局中间件在路由匹配前后最先通过。
  2. 多应用下应用中间件在应用上下文确定后执行。
  3. 路由命中后注册路由中间件。
  4. 控制器实例化后执行控制器中间件,再进入动作方法。

代码或图示

全局中间件 → 应用中间件 → 路由中间件 → 控制器中间件 → 控制器动作
// 四组中间件注册位置示意:全局数组先于应用、路由、控制器
return [
    \think\middleware\SessionInit::class,
];

常见误区

  • 把鉴权挂到控制器中间件却期望拦截未匹配路由:未进入控制器前不会执行。
  • 顺序颠倒导致鉴权晚于业务:拦截失去意义。

追问

  • 应用中间件在单应用下存在吗?答:应用中间件主要在多应用模式下区分,单应用以全局/路由/控制器为主。
  • 同组多个中间件顺序由什么决定?答:注册数组/定义顺序,分组链式注册按调用次序。

06.5.2.5-003 全局中间件在哪里注册?

一句话结论

全局中间件定义在应用的 app/middleware.php(全局中间件定义文件),返回中间件类/别名数组,对当前应用所有请求生效。

概念解释

Session 初始化、跨域、请求缓存等需要覆盖全部请求的中间件在此登记。框架内置中间件默认不启用,按需加入数组。

原理流程

  1. 编辑 app/middleware.php 返回数组。
  2. 引导阶段加载全局中间件定义。
  3. 请求进入链时按数组顺序执行。
  4. 中间件可传别名,别名在中间件配置中映射到类。

代码或图示

// app/middleware.php
return [
    \think\middleware\SessionInit::class,
    \think\middleware\AllowCrossDomain::class,
];

常见误区

  • 在路由文件里注册本该全局生效的中间件:未匹配路由的请求漏掉拦截。
  • 数组顺序随意:前置横切(如跨域预检)应排在业务鉴权之前。

追问

  • 中间件别名在哪里定义?答:中间件配置文件中维护别名到类的映射,具体配置键名以版本手册为准(待确认)。
  • 全局中间件能按路由排除吗?答:可在规则上 withoutMiddleware 排除,8.1.0+ 支持。

06.5.2.5-004 应用中间件在多应用模式下如何生效?

一句话结论

多应用模式下每个应用可维护自己的中间件定义,应用中间件在全局之后、路由之前执行;不同应用的中间件互不影响。

概念解释

应用级中间件服务于特定应用的公共拦截,例如后台应用统一鉴权、接口应用统一跨域。配置随应用目录隔离。

原理流程

  1. 请求识别目标应用。
  2. 加载全局中间件后叠加应用级中间件。
  3. 应用中间件按定义顺序执行。
  4. 再进入路由匹配与路由中间件。

代码或图示

app/
├── admin/middleware.php   # 后台应用中间件
└── api/middleware.php     # 接口应用中间件
// 多应用:app/admin/middleware.php 仅对 admin 应用生效
return [\app\middleware\AdminAuth::class];

常见误区

  • 单应用下寻找应用中间件文件:单应用主要使用全局 middleware.php。
  • 把应用专属拦截写到全局:其他应用被不必要地拦截。

追问

  • 应用中间件配置文件位置?答:多应用目录结构中应用自带 config 与中间件定义,具体文件名以多应用手册为准(待确认)。
  • 全局与应用同名中间件会重复执行吗?答:按注册层级叠加,重复登记会执行多次,需避免重复。

06.5.2.5-005 路由中间件如何注册,支持哪些形式?

一句话结论

规则或分组上调用 ->middleware(),参数可为中间件类、别名、闭包或数组(多个中间件);支持第二参数传入额外参数。

概念解释

路由中间件是最常用的挂载方式,精确到规则或分组。数组形式一次注册多个,别名对应配置中的类映射。

原理流程

  1. 规则定义后链式调用 middleware()。
  2. 框架解析类名/别名/闭包加入规则队列。
  3. 命中路由后按队列顺序执行。
  4. 额外参数随中间件注册传入。

代码或图示

Route::rule('hello/:name', 'hello')
    ->middleware([\app\middleware\Auth::class, 'check']);

Route::group('admin', function () {
    Route::rule('list', 'admin/list');
})->middleware('auth', 'admin');

常见误区

  • 别名未定义就用字符串引用:解析不到中间件类。
  • 多个中间件顺序与预期相反:按数组顺序执行,鉴权应在前。

追问

  • 统一传参与分别传参怎么写?答:数组统一传第二参数;多次调用 middleware() 分别指定不同参数。
  • 路由配置文件里的全局中间件?答:config/route.php 的 middleware 数组对应用下所有请求生效,属路由层全局注册。

06.5.2.5-006 控制器中间件如何定义,only/except 如何限定动作?

一句话结论

控制器类中定义 protected $middleware 属性注册中间件,支持 only 限定生效动作、except 排除动作,中间件名后可用冒号传参。

概念解释

控制器中间件只对该控制器生效,适合类内公共拦截。only 白名单与 except 黑名单控制动作范围。

原理流程

  1. 控制器声明 $middleware 数组。
  2. 框架实例化控制器后解析中间件与动作限定。
  3. 当前动作命中 only 或未被 except 排除则执行。
  4. 再进入动作方法。

代码或图示

class Index
{
    protected $middleware = [
        \app\middleware\Auth::class . ':admin' => ['except' => ['hello']],
        'Hello' => ['only' => ['hello']],
    ];

    public function index() { return 'index'; }
    public function hello() { return 'hello'; }
}

常见误区

  • only 与 except 同时用于同一中间件造成冲突:按一种限定方式维护。
  • 中间件类名拼接冒号参数写错:参数解析失败,需对照手册写法。

追问

  • 控制器中间件在哪个分组执行?答:排在路由中间件之后,是四组中的最后一组。
  • 控制器不继承基类也能定义吗?答:可以,$middleware 属性由框架调度时解析。

06.5.2.5-007 handle($request, \Closure $next) 签名如何工作?

一句话结论

中间件处理方法接收当前 Request 与下一处理闭包 $next;调用 $next($request) 把请求交给下一层,其返回值是最终响应对象,中间件可加工后返回。

概念解释

闭包 $next 封装了后续整条链。中间件不调用 $next 即短路;调用后拿到响应对象做后置处理。

原理流程

  1. 框架构造中间件实例并传入请求与下一闭包。
  2. 前置逻辑执行。
  3. $next($request) 进入后续链并返回 Response。
  4. 后置逻辑加工响应,return 给上一层。

代码或图示

namespace app\middleware;

use think\Request;
use think\Response;

class LogAccess
{
    public function handle(Request $request, \Closure $next): Response
    {
        $start = microtime(true);
        $response = $next($request);
        $cost = round((microtime(true) - $start) * 1000, 2);
        $response->header(['X-Use-Time' => (string) $cost]);
        return $response;
    }
}

常见误区

  • 忘记 return $next 结果:上层收到空响应。
  • 后置逻辑修改请求而非响应:后置阶段应加工 Response。

追问

  • 中间件可以返回非 Response 吗?答:闭包中间件必须返回 Response 实例;类中间件返回值按框架响应约定处理,细节以版本源码为准。
  • $next 闭包能否重复调用?答:标准链只放行一次,重复调用会重复进入后续处理,不建议。

06.5.2.5-008 前置逻辑与后置逻辑分别写在哪里?

一句话结论

$next($request) 之前是前置逻辑(鉴权、参数预处理、请求记录),之后是后置逻辑(响应头、耗时统计、响应加工);后置逻辑拿到的是控制器产出的响应。

概念解释

位置决定执行时机:前置在控制器之前可阻断请求,后置在控制器之后只能装饰响应。读请求放前面,改响应放后面。

原理流程

  1. 前置:校验身份、解析令牌、写入请求属性。
  2. 调用 $next 进入控制器。
  3. 后置:读取响应、补头部、记录日志。
  4. 返回加工后的响应。

代码或图示

public function handle($request, \Closure $next)
{
    // 前置:鉴权
    if (!$request->header('token')) {
        return json(['code' => 401, 'msg' => '未登录'], 401);
    }
    $response = $next($request);
    // 后置:统一响应头
    $response->header(['X-App' => 'ann-interview']);
    return $response;
}

常见误区

  • 在后置阶段读原始请求参数做鉴权:时机已晚,请求已被处理。
  • 前置逻辑里修改响应对象:响应此时尚未生成。

追问

  • 后置能改响应体吗?答:可以读取并加工 Response 内容,注意序列化格式与中间件顺序。
  • 日志应前置还是后置?答:请求摘要前置记录,结果与耗时后置补充。

06.5.2.5-009 短路返回如何实现?

一句话结论

中间件不调用 $next($request),直接返回 Response 对象即短路:后续中间件与控制器不再执行,响应直接沿链返回。

概念解释

短路用于鉴权失败、限流拒绝、跨域预检等场景。返回的响应状态码与结构由中间件决定。

原理流程

  1. 前置判断不通过。
  2. 构造错误/重定向响应并 return。
  3. 不调用 $next,后续链中断。
  4. 响应反向穿过已执行中间件的后置逻辑。

代码或图示

public function handle($request, \Closure $next)
{
    if (!$this->check($request)) {
        return json(['code' => 403, 'msg' => '禁止访问'], 403);
    }
    return $next($request);
}

常见误区

  • 短路后仍执行后续清理:未进入的中间件后置逻辑不会运行,必要清理应在本中间件内完成。
  • 短路返回字符串而非 Response:部分场景框架会包装,但闭包中间件要求返回 Response。

追问

  • 鉴权失败响应结构如何统一?答:在异常处理器或基础中间件中约定 JSON 结构,避免各中间件自拼。
  • 短路会触发控制器初始化吗?答:不会,控制器在后续链中才实例化。

06.5.2.5-010 中间件如何把参数传给控制器?

一句话结论

前置阶段给 $request 对象赋值自定义属性,控制器通过注入的 Request 读取;传递必须在放行前完成。

概念解释

请求对象是中间件与控制器之间的共享载体。中间件解析出的用户身份、校验结果挂到请求属性上,避免重复解析。

原理流程

  1. 中间件前置解析令牌得到用户信息。
  2. $request->user = $user 写入属性。
  3. 调用 $next 放行。
  4. 控制器方法注入 Request,读取 $request->user。

代码或图示

// 中间件
public function handle($request, \Closure $next)
{
    $request->authUser = $this->resolveUser($request);
    return $next($request);
}
// 控制器
public function index(\think\Request $request)
{
    $user = $request->authUser;
}

常见误区

  • 后置阶段才给请求赋值:控制器已执行,读取不到。
  • 直接修改请求原始参数数组:应通过属性传递派生数据,避免污染输入。

追问

  • 多中间件传值有顺序要求吗?答:依赖上游属性的中间件必须排在提供方之后。
  • 请求属性类型需要声明吗?答:PHP 动态属性按对象运行期行为处理,建议在自定义 Request 类中声明。

06.5.2.5-011 中间件额外参数如何传入?

一句话结论

路由注册中间件时第二参数传入字符串参数,中间件 handle 方法可声明第三个形参接收;控制器中间件用类名冒号后接参数。

概念解释

参数让同一中间件复用不同配置,例如 auth:admin 表示后台鉴权角色。参数随中间件注册固定传入。

原理流程

  1. 注册时 middleware('auth', 'admin')。
  2. 框架实例化中间件并把参数传入处理方法。
  3. handle($request, $next, $role) 接收参数。
  4. 中间件按参数选择校验逻辑。

代码或图示

Route::rule('admin/list', 'admin/list')->middleware('auth', 'admin');
public function handle($request, \Closure $next, string $role = '')
{
    if (!$this->hasRole($request, $role)) {
        return json(['code' => 403], 403);
    }
    return $next($request);
}

常见误区

  • 中间件方法未声明参数形参:注册参数被忽略。
  • 参数与中间件内校验逻辑不匹配:角色/类型判断落空。

追问

  • 多个中间件分别传参怎么写?答:多次调用 middleware(),每次指定中间件与参数;数组形式可统一传同一参数。
  • 参数支持数组吗?答:以框架中间件解析实现为准(待确认),复杂配置建议走配置文件。

06.5.2.5-012 闭包中间件怎么写,返回值有什么要求?

一句话结论

路由分组/规则可直接注册闭包作为中间件,闭包签名为 function($request, \Closure $next),必须返回 Response 实例。

概念解释

闭包中间件适合简单临时拦截,省去建类文件;复杂可复用逻辑仍应抽成中间件类。

原理流程

  1. middleware() 传入闭包。
  2. 框架按闭包签名注入请求与下一闭包。
  3. 闭包内做判断或预处理。
  4. 返回 $next($request) 或短路 Response。

代码或图示

Route::group('hello', function () {
    Route::rule('hello/:name', 'hello');
})->middleware(function ($request, \Closure $next) {
    if ($request->param('name') === 'think') {
        return redirect('index/think');
    }
    return $next($request);
});

常见误区

  • 闭包返回数组/字符串:未包装为 Response,响应行为不确定。
  • 在闭包里写长业务逻辑:不可复用且难测试,应抽类。

追问

  • 闭包中间件能传第三参数吗?答:路由闭包中间件主要接收请求与 $next,额外参数建议通过请求属性或配置获取。
  • 闭包中间件支持依赖注入吗?答:参数按闭包签名解析,对象类型可由容器注入,具体支持程度以版本为准。

06.5.2.5-013 框架内置中间件有哪些?

一句话结论

内置中间件包括 AllowCrossDomain(跨域)、CheckRequestCache(请求缓存)、LoadLangPack(多语言加载)、SessionInit(Session 初始化)、FormTokenCheck(表单令牌),默认均未启用,按需在中间件定义中登记。

概念解释

这些核心横切能力以中间件形式提供,可灵活关闭。新版部分功能(Session、请求缓存、多语言)由中间件处理。

原理流程

  1. 在 middleware.php 加入所需内置中间件类。
  2. 请求进入链时按顺序执行。
  3. 各中间件初始化对应组件或拦截请求。
  4. 不需要的功能保持不注册。

代码或图示

return [
    \think\middleware\SessionInit::class,
    \think\middleware\CheckRequestCache::class,
    \think\middleware\LoadLangPack::class,
];

常见误区

  • 以为 Session 默认开启:需注册 SessionInit 中间件后才可使用 Session。
  • 重复注册内置与自研同名中间件:同一逻辑执行多次。

追问

  • 表单令牌中间件做什么?答:FormTokenCheck 校验请求中的令牌,配合验证器 token 规则防重复提交。
  • 请求缓存中间件缓存什么?答:按路由缓存响应内容,缓存时长由路由参数/配置控制。

06.5.2.5-014 跨域(CORS)如何处理?

一句话结论

可使用内置 AllowCrossDomain 中间件,或安装 topthink/think-cors 扩展并在 config/cors.php 配置允许来源、方法、头、凭证与预检缓存。

概念解释

跨域处理需响应正确的 Access-Control-* 头,并处理 OPTIONS 预检请求。凭证开启时来源不能为通配符。

原理流程

  1. 安装/启用跨域中间件或扩展。
  2. 配置允许来源、方法、请求头与 max_age。
  3. 预检请求直接返回带跨域头的响应。
  4. 实际请求附加跨域头后继续链路。

代码或图示

// config/cors.php 配置示意(键名以扩展手册为准)
return [
    'paths' => ['api/*'],
    'allowed_origins' => ['https://example.com'],
    'allowed_methods' => ['GET', 'POST', 'PUT', 'DELETE'],
    'allowed_headers' => ['Authorization', 'Content-Type'],
    'supports_credentials' => true,
    'max_age' => 7200,
];

常见误区

  • 开启凭证后允许来源写 *:浏览器拒绝带凭证的通配符跨域。
  • 只处理实际请求漏掉 OPTIONS 预检:预检失败前端拿不到接口。

追问

  • 多域名/正则来源怎么配?答:扩展支持 allowed_origins_patterns 正则模式,按手册配置。
  • 跨域头应由谁添加?答:跨域中间件在链最外层添加,确保响应最终携带头信息。

06.5.2.5-015 限流中间件如何实现?

一句话结论

基于缓存计数实现滑动/固定窗口限流:中间件前置读取计数器,超限直接短路拒绝,未超限计数递增并设置过期时间。

概念解释

限流是中间件前置拦截的典型场景。计数器按用户 ID/IP/接口维度区分,存储可用缓存组件(文件/Redis 驱动)。

原理流程

  1. 构造限流键(维度 + 接口)。
  2. 读取缓存计数与窗口。
  3. 超限返回 429/403 响应;未超限计数 +1,首次写入设置过期。
  4. 放行到后续链。

代码或图示

public function handle($request, \Closure $next)
{
    $key = 'rate:' . ($request->ip() ?: 'guest');
    $count = \think\facade\Cache::get($key, 0);
    if ($count >= 60) {
        return json(['code' => 429, 'msg' => '请求过于频繁'], 429);
    }
    \think\facade\Cache::set($key, $count + 1, 60);
    return $next($request);
}

常见误区

  • 计数未设过期:永久计数导致后续全部拒绝。
  • 用文件缓存做高并发限流:原子性与性能有限,生产建议 Redis 驱动。

追问

  • 固定窗口与滑动窗口区别?答:固定窗口按时间片计数有临界突刺;滑动窗口按时间戳集合衰减,实现更复杂。
  • 限流响应头要带什么?答:可补充 Retry-After 与剩余次数头,具体规范按业务接口约定。

06.5.2.5-016 分组中间件与 withoutMiddleware 排除如何使用?

一句话结论

分组注册的中间件对组内全部规则生效;单条规则可用 withoutMiddleware() 排除指定中间件(8.1.0+),支持数组传入排除项。

概念解释

公共拦截上提分组,个别开放接口单独豁免。排除只作用于规则本身,不影响分组其他规则。

原理流程

  1. 分组链式 middleware() 注册公共中间件。
  2. 组内开放规则调用 withoutMiddleware()。
  3. 框架合并链时移除被排除项。
  4. 其余规则仍执行分组中间件。

代码或图示

Route::group('blog', function () {
    Route::get(':id/edit', 'blog/edit');
    Route::put(':id', 'blog/update');
    Route::get(':id', 'blog/read')->withoutMiddleware(); // 无需鉴权
})->middleware(\app\middleware\Auth::class);

常见误区

  • 旧版本使用 withoutMiddleware:该方法为 8.1.0+ 特性,低版本需换方案。
  • 排除参数写错:应传需排除的中间件类/别名,留空表示排除全部。

追问

  • 排除后全局中间件还执行吗?答:withoutMiddleware 针对分组/路由层注册项,全局中间件按其定义仍执行。
  • 排除行为如何测试?答:分别访问受保护与豁免规则,观察鉴权是否生效。

06.5.2.5-017 中间件别名如何定义与使用?

一句话结论

别名是中间件类的短名映射,路由/分组注册时用字符串别名引用;别名可对应一个或多个中间件,映射在中间件配置中维护。

概念解释

别名减少重复书写完整类名,也便于统一调整中间件实现。别名注册位置与配置键名以版本手册为准(待确认)。

原理流程

  1. 在中间件配置中登记 'auth' => \app\middleware\Auth::class。
  2. 路由 ->middleware('auth') 引用别名。
  3. 框架解析别名到类并实例化。
  4. 别名可指向数组组合多个中间件。

代码或图示

// 别名配置示意,实际文件与键名以版本手册核对
return [
    'alias' => [
        'auth'  => \app\middleware\Auth::class,
        'check' => [\app\middleware\Check::class],
    ],
];

常见误区

  • 别名未定义却在路由使用:解析失败报中间件未找到。
  • 别名指向闭包:别名通常映射类,闭包直接在路由注册。

追问

  • 内置中间件有默认别名吗?答:以框架默认中间件配置为准,可阅读 config/middleware.php 注释确认。
  • 改别名实现影响范围?答:所有引用该别名的路由统一生效,调整前盘点使用点。

06.5.2.5-018 中间件中抛出异常如何被接管?

一句话结论

中间件抛出的异常进入框架异常处理器,按类型映射状态码与响应结构;中间件自身只处理可预期的拦截响应,未捕获异常交由统一处理器收口。

概念解释

鉴权失败等可预期场景可短路返回;参数/系统异常抛出后由 ExceptionHandle 渲染,避免每个中间件自拼错误响应。

原理流程

  1. 中间件执行中抛出异常或 ValidateException。
  2. 异常沿调用链向上进入异常处理器。
  3. 处理器记录日志并按类型生成响应。
  4. 响应沿已执行中间件后置逻辑返回。

代码或图示

public function handle($request, \Closure $next)
{
    if (!$this->valid($request)) {
        throw new \think\exception\HttpException(403, '禁止访问');
    }
    return $next($request);
}

常见误区

  • 每个中间件 try/catch 后自拼响应:错误结构不统一。
  • 异常处理器把堆栈返回生产客户端:按环境区分调试详情。

追问

  • HttpException 状态码如何映射?答:异常携带状态码,处理器按码渲染对应响应,异常类名以框架源码为准(待确认)。
  • 中间件异常会触发控制器吗?答:不会,异常在到达控制器前中断链路。

06.5.2.5-019 中间件类支持依赖注入吗?

一句话结论

支持:中间件构造器可声明类型依赖由容器注入,handle 方法参数除请求与 $next 外也可按类型注入对象;标量参数来自注册传参。

概念解释

中间件由容器实例化,复用容器解析能力。需要复用服务(如用户解析器)时走构造器注入,保持中间件可测试。

原理流程

  1. 中间件构造方法声明服务依赖。
  2. 框架解析中间件类时容器注入构造依赖。
  3. handle 签名追加可注入对象参数。
  4. 中间件在拦截逻辑中使用注入服务。

代码或图示

class Auth
{
    public function __construct(private \app\service\UserResolver $resolver) {}

    public function handle($request, \Closure $next)
    {
        $request->authUser = $this->resolver->fromRequest($request);
        return $next($request);
    }
}

常见误区

  • 中间件里手动 new 服务:绕过容器,无法替换测试。
  • 构造器注入请求对象:请求由 handle 参数传入,不在构造器取。

追问

  • 中间件单例还是每次实例化?答:按框架容器规则解析,实例复用策略以版本源码为准(待确认)。
  • 注入配置类可以吗?答:配置通过 Config 门面/助手读取,无需注入整个配置容器。

06.5.2.5-020 中间件顺序错误会导致什么后果,如何排查?

一句话结论

顺序错误会导致鉴权失效、跨域头丢失、Session 未初始化就读取等问题;排查沿四组顺序检查注册文件、分组与数组次序,并用请求日志/响应头验证每一层是否执行。

概念解释

中间件是有序管道,前置能力(跨域、Session、鉴权)必须排在业务之前。排查先定位问题属于哪一层拦截,再核对注册顺序。

原理流程

  1. 复现问题:未授权可访问 / 跨域头缺失 / Session 为空。
  2. 按全局 → 应用 → 路由 → 控制器顺序核对注册。
  3. 检查分组继承与 withoutMiddleware 是否误排除。
  4. 在各中间件前置/后置加临时日志,确认执行次序与取值。

代码或图示

排查顺序:
1. app/middleware.php 全局数组次序
2. 多应用应用级中间件
3. 路由分组与规则 middleware() 注册次序
4. 控制器 $middleware 的 only/except 限定
// 排查时在中间件前后打点,确认执行次序与取值
public function handle($request, \Closure $next)
{
    \think\facade\Log::info('middleware enter', ['method' => $request->method()]);
    return $next($request);
}

常见误区

  • 只看中间件内部逻辑不看顺序:问题出在层间依赖而非判断条件。
  • 调试日志写在后置:前置未执行的中间件看不到记录。

追问

  • Session 读不到先查什么?答:先确认 SessionInit 中间件已在全局链注册且排在读取 Session 的中间件之前。
  • 跨域头缺失先查什么?答:确认跨域中间件在链最外层,预检 OPTIONS 是否被正确放行。