laravel中间件常见问题包括类未找到、未生效、参数传递失败和顺序错乱；需检查路径命名空间、注册方式、参数接收方式及执行顺序。
中间件类找不到：Class not found 错误
这是最常见的情况，Laravel 在注册中间件时找不到对应类，直接报 Class 'App\Http\Middleware\CheckAge' not found。根本原因不是写错了名字，而是命名空间或自动加载没对上。
- 检查类文件路径是否严格为
app/Http/Middleware/YourMiddleware.php，Laravel 不认子目录（比如app/Http/Middleware/Auth/ApiAuth.php默认不扫描） - 确认类声明的命名空间是
namespace App\Http\Middleware;，别手误写成App\Middleware或漏掉Http - 改完类名或命名空间后，必须运行
composer dump-autoload，否则 PSR-4 自动加载缓存不会更新 - 如果用 PHP 8.1+，注意中间件类不能是
final—— Laravel 会尝试代理它，final类会导致实例化失败
中间件没生效：路由里写了但完全不执行
看起来注册了、也用了，但断点打进去就是不进 handle() 方法。大概率是中间件没正确“注册”或“绑定”到请求生命周期。
- 全局中间件要加到
$middleware数组（app/Http/Kernel.php），不是$middlewareGroups；后者只在指定分组（如web、api）中生效 - 路由内使用
->middleware(CheckAge::class)时，确保传的是类名（CheckAge::class），不是字符串'check.age'—— 后者需要先在$routeMiddleware里映射过 - 如果用字符串别名（如
'auth'），检查$routeMiddleware是否真有这一项：'auth' => \App\Http\Middleware\Authenticate::class，拼写大小写敏感 - API 路由默认走
api中间件组，而VerifyCsrfToken默认只在web组里 —— 别指望它在 API 请求里自动拦截表单提交
中间件参数传递失败：$request 和 $next 后面的参数收不到
Laravel 的 handle() 方法签名固定为 handle($request, Closure $next, ...$params)，但很多人以为能像控制器那样直接写 handle(Request $request, Closure $next, string $role) 就能自动注入 —— 实际不行。
- 中间件参数只能通过路由定义传入，比如
Route::get('/admin')->middleware('role:admin,sudo')，然后在handle里用...$params接收，$params是数组['admin', 'sudo'] - 类型提示（如
string $role）会被忽略，PHP 会报ArgumentCountError，因为 Laravel 调用时只传两个固定参数 + 可变参数数组 - 想做复杂参数解析？自己在
handle()里拆$params[0]，别依赖框架自动转换
中间件顺序错乱导致逻辑异常
比如你写了日志中间件和权限中间件，但日志里永远看不到被拦截的请求 —— 因为权限中间件在前面直接 return 了，后面中间件根本没机会执行。
- 中间件执行顺序 = 数组定义顺序（
$middleware或$middlewareGroups里的位置），越靠前越先执行，也越早能return截断流程 - 想让日志记录所有进入的请求（包括被拒的），日志中间件必须放在权限/认证类中间件之前
- CSRF 验证必须在 Session 启动之后（
StartSession之后），否则拿不到 token；所以VerifyCsrfToken必须排在StartSession下方 - 调试顺序问题？在每个中间件
handle()开头加Log::debug('in ' . static::class);，看日志输出顺序
中间件的坑不在语法多难，而在它嵌套在请求生命周期里，一环扣一环。少一个 return $next($request)，或者顺序颠倒半步，整个链就断了，还很难定位。动手前先想清楚：这个中间件到底该在哪一层介入，又该把控制权交给谁。
