Laravel 10及更早版本中，路由中间件必须在app/Http/Kernel.php的$routeMiddleware数组中显式注册别名，键为字符串名（如'age'），值为完整命名空间类名（如\App\Http\Middleware\CheckAge::class），否则调用->middleware('xxx')会报“Undefined middleware”错误。
在 Laravel 10 及更早版本中，路由中间件必须显式注册别名，才能在路由定义里用 ->middleware('xxx') 调用。不注册就直接写，会报 “Undefined middleware” 错误——这不是代码写错了，而是 Laravel 根本没认出这个别名。
在 app/Http/Kernel.php 中注册路由中间件别名
打开 app/Http/Kernel.php，找到 $routeMiddleware 数组（不是 $middleware 或 $middlewareGroups）。所有你打算通过字符串名（比如 'auth'、'role'）在路由中使用的中间件，都得在这里配成键值对：
- 键是你要在路由里写的别名，例如
'age'、'check.permission' - 值是完整命名空间下的类名，例如
\App\Http\Middleware\CheckAge::class - 别名不自动推导，大小写敏感，不能含非法字符
示例：
protected $routeMiddleware = [
'auth' => \App\Http\Middleware\Authenticate::class,
'age' => \App\Http\Middleware\CheckAge::class,
'role' => \App\Http\Middleware\RoleMiddleware::class,
];
确保中间件类存在且路径正确
注册前，中间件类必须已生成并放在 app/Http/Middleware/ 目录下。可用 Artisan 命令快速创建：
立即学习“PHP免费学习笔记（深入）”；
php artisan make:middleware CheckAge
生成后检查类文件是否包含正确的命名空间和 handle 方法，且该方法最后必须返回 $next($request) 或一个响应对象（如 return redirect(...)），否则请求会卡住。
注册后怎么在路由中使用
别名注册成功后，即可在路由文件（如 routes/web.php）中使用：
- 单个路由：
Route::get('/profile', [ProfileController::class, 'show'])->middleware('age'); - 路由组：
Route::middleware(['auth', 'age'])->group(function () { ... }); - 带参数的写法（需 handle 方法支持）：
->middleware('role:admin')，对应handle($request, $next, $role)
注意：带参中间件不能放进中间件组（$middlewareGroups），只能在路由级单独绑定。
常见错误排查点
- 拼写错误：别名在
$routeMiddleware里写成'agee'，但路由里写了'age' - 命名空间错误：类名漏了
::class，或路径写成App\Http\Middleware\CheckAge（少\开头） - 混淆注册位置：把路由中间件错加到
$middleware（全局）或$middlewareGroups（组）里 - 缓存未清除：修改 Kernel.php 后，如果启用了配置缓存，需运行
php artisan config:clear
