Laravel 不支持运行时动态注册中间件，但可通过组合多个认证守卫（guards）实现“按需切换”的效果，例如根据请求头自动选择 token 或 Sanctum 认证。
laravel 不支持运行时动态注册中间件，但可通过组合多个认证守卫（guards）实现“按需切换”的效果，例如根据请求头自动选择 token 或 sanctum 认证。
在 Laravel 中，无法真正“动态添加”中间件到已启动的应用生命周期中（如运行时 app('router')->pushMiddlewareToGroup()），因为中间件绑定发生在路由注册阶段，且框架未提供安全、稳定的运行时中间件注入机制。但这并不意味着需求无法实现——关键在于将“动态判断逻辑”前置到中间件自身或守卫（Guard）层面，而非试图动态挂载中间件类。
✅ 推荐方案：利用 auth 中间件的多守卫支持
Laravel 原生支持为 auth 中间件传入多个守卫名称，它会按顺序尝试认证，一旦某个守卫成功返回用户实例，即停止后续检查并继续请求流程：
// routes/web.php 或 routes/api.php
Route::middleware('auth:token,sanctum')->group(function () {
Route::get('/dashboard', [DashboardController::class, 'index']);
});
? 前提条件：
- 确保
config/auth.php中已正确定义token和sanctum守卫； -
token守卫需自定义（例如基于请求头X-Token解析 JWT），并注册到AuthManager； -
sanctum守卫需已配置（通常由laravel/sanctum自动注册）。
? 示例：快速定义 token 守卫
在 App\Providers\AuthServiceProvider 的 boot() 方法中注册：
use Illuminate\Support\Facades\Auth;
use Illuminate\Auth\TokenGuard;
public function boot()
{
$this->registerPolicies();
Auth::extend('token', function ($app, $name, array $config) {
return new TokenGuard(
Auth::createUserProvider($config['provider']),
$app->request
);
});
}
再在 config/auth.php 的 'guards' 数组中添加：
'token' => [
'driver' => 'token',
'provider' => 'users',
],
⚠️ 注意事项：
- 多守卫认证是顺序执行、短路失败：若
token守卫抛出异常或返回null，Laravel 会立即尝试sanctum，不会跳过； - 两个守卫不可同时成功（否则可能引发权限歧义），建议在业务逻辑中明确区分使用场景（如 API 路由统一走
auth:token,sanctum，Web 路由仅用sanctum）； - 避免在中间件内手动调用
app('router')->middleware()等非常规操作——这属于未公开 API，极易导致路由缓存失效或并发问题。
? 进阶提示：如需更精细控制（如记录认证来源、拒绝混合认证），可封装一个自定义中间件（如 AuthenticateViaHeader），内部调用 Auth::guard()->attempt() 或 Auth::shouldUse() 主动切换，并统一处理响应逻辑。
总结：不要追求“动态添加中间件”，而应善用 Laravel 的守卫抽象与中间件组合能力——简洁、安全、符合框架设计哲学。
