Laravel9中AppServiceProvider的boot方法调用Route::current()->getName()报错

原因分析 #

Laravel服务提供者的执行生命周期里，AppServiceProvider的boot方法触发时，路由系统还未完成注册与请求匹配。URL::current()和Request::url()仅依赖请求的原始URL信息，不需要路由匹配就能获取；但Route::current()需要路由系统完成请求与对应路由的绑定后，才能返回有效路由实例，此时还未到这个阶段，所以返回null，调用getName()自然会报错。

解决办法 #

方法1：用路由中间件处理 #

中间件是在路由匹配完成后执行的，此时Route::current()能正常获取路由实例：

1. 创建中间件：

php artisan make:middleware RouteNameMiddleware

2. 在中间件的handle方法中编写逻辑：

public function handle(Request $request, Closure $next)
{
    $routeName = Route::current()->getName();
    // 这里可以做日志记录、数据绑定等操作
    \Log::info('当前路由名称：'.$routeName);
    
    return $next($request);
}

3. 在app/Http/Kernel.php中注册中间件，可全局注册或绑定到指定路由组：

// 全局中间件（所有请求触发）
protected $middleware = [
    // ...其他中间件
    \App\Http\Middleware\RouteNameMiddleware::class,
];

// 或者绑定到web路由组
protected $middlewareGroups = [
    'web' => [
        // ...其他中间件
        \App\Http\Middleware\RouteNameMiddleware::class,
    ],
];

方法2：监听路由匹配事件 #

监听Illuminate\Routing\Events\RouteMatched事件，该事件在路由匹配完成后触发：

1. 创建事件监听器：

php artisan make:listener RouteMatchedListener --event=Illuminate\Routing\Events\RouteMatched

2. 在监听器的handle方法中处理逻辑：

public function handle(RouteMatched $event)
{
    $routeName = $event->route->getName();
    \Log::info('当前路由名称：'.$routeName);
    // 其他业务逻辑
}

3. 在app/Providers/EventServiceProvider.php中注册事件关联：

protected $listen = [
    \Illuminate\Routing\Events\RouteMatched::class => [
        \App\Listeners\RouteMatchedListener::class,
    ],
];

方法3：延迟执行逻辑（适合视图共享场景） #

如果是要给视图共享路由名称，可使用视图composer，它会在视图渲染时执行，此时路由已匹配完成：

// 在AppServiceProvider的boot方法中
public function boot()
{
    View::composer('*', function ($view) {
        // 用空安全运算符避免无路由时报错
        $routeName = Route::current()?->getName();
        $view->with('currentRouteName', $routeName);
    });
}

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