Laravel 11 中自定义中间件需在 bootstrap/app.php 注册别名、全局应用或路由绑定；先用 artisan 创建中间件类，再通过 $middleware->alias() 注册别名，最后按需用于路由、路由组、全局或 web/api 链。
在 Laravel 11 中，自定义中间件的注册完全收口到 bootstrap/app.php，不再使用旧版的 app/Http/Kernel.php。你需要在这个文件里完成中间件的别名注册、全局应用和路由绑定三件事。
第一步：创建中间件类
先用 Artisan 命令生成中间件文件：
php artisan make:middleware CheckPermission
它会自动创建 app/Http/Middleware/CheckPermission.php，确保命名空间是 App\Http\Middleware，且 handle() 方法签名正确（含 Request $request 和 Closure $next），并记得 必须返回 $next($request) 或一个响应实例。
第二步：在 bootstrap/app.php 中注册别名
打开 bootstrap/app.php，找到 withMiddleware() 闭包，在里面调用 $middleware->alias()：
立即学习“PHP免费学习笔记（深入）”；
$middleware->alias('permission', \App\Http\Middleware\CheckPermission::class);- 别名建议用小写字母加点号分隔（如
'role.admin'），不能含空格或特殊符号 - 不要和内置别名（如
auth、throttle）冲突
第三步：选择生效方式
注册完别名后，按需决定中间件作用范围：
- 用于特定路由：在路由定义中直接调用 →
Route::get('/admin')->middleware('permission'); - 用于整组路由：配合
middleware()链式调用 →Route::middleware(['permission', 'auth'])->group(...) - 作为全局中间件（每次请求都执行）：用
$middleware->use()→$middleware->use([\App\Http\Middleware\LogRequest::class]); - 注入到 web 或 api 链：用
$middleware->web([...])或$middleware->api([...])，注意它们不带认证逻辑，需手动加auth等别名
常见错误提醒
这些细节容易出错，建议检查：
- 中间件类路径写错（比如漏了
App\Http\Middleware\命名空间）→ 报Class not found - 忘记在
withMiddleware()里调用alias()→ 路由中用middleware('xxx')会失效 -
handle()方法里写了判断但没return响应或$next($request)→ 请求卡住、无响应、无报错 - 想在中间件里用
Auth::user()却放在web()数组靠前位置 → 用户对象为 null，应确保它排在auth后面或改用 guard 显式获取
