Laravel 11无法自定义'api'中间件别名以使用依赖库

核心原因分析 #

你遇到的问题大概率是Laravel 11默认的api中间件组与你自定义的api别名冲突，或者配置缓存导致新的别名未生效。

Laravel 11框架默认自带api中间件组（包含throttle:api、bindings等中间件），当你通过$middleware->alias()将api定义为单个中间件的别名时，框架可能优先识别默认的api中间件组，而非你自定义的别名，导致你的AuthMiddleware从未被调用。

分步解决方案 #

方案1：将自定义中间件加入默认api中间件组（推荐） #

不需要替换api别名，直接把你的AuthMiddleware添加到默认的api中间件组中，这样供应商库的middleware('api')会执行组内所有中间件，包括你的认证逻辑：

->withMiddleware(function (Middleware $middleware) {
    // 保留原有的sso别名配置（如果需要）
    $middleware->alias([
        'sso' => AuthMiddleware::class,
    ]);

    // 将自定义中间件加入api中间件组
    $middleware->appendToGroup('api', AuthMiddleware::class);
})

方案2：替换默认api中间件组为自定义中间件 #

如果你希望api中间件直接指向你的AuthMiddleware，可以先移除默认的api中间件组，再定义别名：

->withMiddleware(function (Middleware $middleware) {
    // 移除默认的api中间件组
    $middleware->removeGroup('api');

    // 定义api别名指向自定义中间件
    $middleware->alias([
        'api' => AuthMiddleware::class,
    ]);
})

方案3：强制刷新配置缓存 #

如果上述配置修改后仍不生效，可能是配置缓存导致旧配置残留，执行以下命令清除缓存：

php artisan optimize:clear

额外检查项 #

• 确认AuthMiddleware的命名空间正确，文件路径无误，handle方法逻辑正常（比如不要提前返回而跳过dd()调试代码）。
• 访问供应商库的路由时，确认请求确实携带了门户生成的会话Cookie，避免因Cookie缺失导致中间件逻辑提前退出。

内容的提问来源于stack exchange，提问作者naspy971