Laravel中间件是嵌套请求处理链,执行顺序由注册位置决定:全局中间件($middleware)最外层、路由组中间件($middlewareGroups)居中、路由级中间件最内层;三者按定义顺序从外到内执行请求、反向执行响应。

Laravel 中间件不是“插件”,而是一层嵌套的请求处理链。执行顺序不靠数字优先级,而是由注册位置和调用时机决定:越靠外的中间件越早拦截请求、越晚处理响应。
全局中间件:包裹整个应用的最外层
在 app/Http/Kernel.php 的 $middleware 数组中定义,所有 HTTP 请求必经此层。它像一个大罩子,把整个请求生命周期包在里面。
- 适合放基础支撑类逻辑:加密 Cookie、信任代理、维护模式拦截、日志入口
- 注意隐式依赖:比如
EncryptCookies必须在StartSession之前,否则 session 无法解密;StartSession又必须在VerifyCsrfToken之前,否则 token 验证失败 - 数组里写得越靠前,实际执行时越“靠外”——也就是请求进来最先碰到、响应出去最后离开
路由组中间件:按用途分组的中间层
定义在 app/Http/Kernel.php 的 $middlewareGroups 数组中,如 web 和 api。它们不会自动生效,必须显式绑定到路由组上。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
-
web组默认包含 session、CSRF、共享错误等,适用于带页面交互的请求 -
api组默认无 session、无 CSRF,轻量高效,专为前后端分离设计 - 在
routes/web.php中使用Route::middleware('web')或直接用Route::group(['middleware' => 'web'], ...)激活 - 多个中间件同属一组时,数组顺序即执行顺序,例如
['auth', 'throttle']表示先认证、再限流
路由级中间件:离控制器最近的最后一道关卡
直接在单个路由或控制器方法上绑定,通过 ->middleware() 调用,是整个中间件栈最内层。
- 适合做精准控制:权限校验(如
can:edit,post)、参数预处理、租户识别、灰度分流 - 支持传参:
->middleware('role:admin,editor'),参数会传入中间件handle方法的第三个参数 - 若同时用了路由组 + 单个路由中间件,后者会追加在前者之后,不是覆盖
- 务必记得调用
return $next($request),漏掉会导致请求链中断,控制器收不到请求,且无报错提示
验证与调试中间件顺序的实用技巧
别猜,动手看。最可靠的方式是在每个中间件的 handle() 开头加一行输出:
- 用
Log::info('In MyMiddleware', ['path' => $request->path()]);记录日志 - 临时用
dd('MyMiddleware', $request->path());中断并查看执行流(上线前务必删掉) - 注意不要在
terminate()方法里调试顺序,它和主请求流程异步,不参与中间件链执行 - API 路由默认走
api组,web 路由走web组,两组完全隔离,查错时别跨组比对


















