Laravel自定义中间件组_WebApiAdmin中间件分组【方法】-php教程-PHP中文网

自定义中间件组必须注册到 $middlewaregroups 而非 $middleware，因为 $middleware 是全局应用的，会导致 /storage、/health 等非业务路由被无差别拦截；而 $middlewaregroups 可按需绑定到特定路由组，确保精准控制执行范围。

laravel自定义中间件组_webapiadmin中间件分组【方法】

自定义中间件组必须注册到 $middlewareGroups，不能塞进 $middleware；否则所有请求（包括 /storage 图片、/health 接口）都会被拦截。

为什么不能往 `$middleware` 里加后台中间件

全局中间件数组 $middleware 在 app/Http/Kernel.php 里，它对每个 HTTP 请求无差别执行。哪怕你只想要 /admin 路由走权限校验，一旦把 AdminAuthMiddleware::class 塞进这里：

网站首页 / 会跳登录页
/storage/app/public/logo.png 返回 401
/api/health 被拒绝，K8s 探针失败

这不是“没配好”，是设计意图完全错位。

正确注册方式：加到 `$middlewareGroups['admin']`

打开 app/Http/Kernel.php，在 $middlewareGroups 数组里新增一个键值对：

protected $middlewareGroups = [
    'web' => [ /* ... */ ],
    'api' => [ /* ... */ ],
    'admin' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
        \Illuminate\Routing\Middleware\SubstituteBindings::class,
        \App\Http\Middleware\AdminAuthMiddleware::class,
        \App\Http\Middleware\CheckAdminRoleMiddleware::class,
    ],
];

注意几点：

别漏掉基础中间件（如 StartSession），否则 session() 在 admin 路由里不可用
顺序很重要：AdminAuthMiddleware 应该在 SubstituteBindings 之后，确保路由参数已解析
别用 auth 别名——那是 web 组的，admin 组要自己维护完整链

路由分组时必须显式调用 `middleware('admin')`

注册完不等于自动生效。你在 routes/web.php 中必须这样写：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

Route::middleware('admin')->prefix('admin')->group(function () {
    Route::get('/dashboard', [AdminController::class, 'index']);
    Route::get('/users', [AdminController::class, 'list']);
});

常见错误：