Laravel自定义服务Provider中auth中间件路由跳转至/home问题

问题描述 #

在自定义服务提供者的boot方法中添加如下路由代码：

Route::prefix($this->prefix)
        ->middleware('auth')
        ->group(app_path($this->module_path. '/Routes/route.php'));

访问该路由文件中的路由时，会被重定向至/home。但移除auth中间件、将路由定义在Laravel默认路由文件或RouteServiceProvider中时，该问题不会出现，仅在自定义服务提供者中定义路由时触发此重定向。

复现步骤 #

• 在新的服务提供者中添加上述代码；
• 在app.php中注册该服务提供者；
• 在步骤1指定的路由文件中创建路由；
• 访问路由，验证是否跳转至/home。

解决方案 #

1. 调整服务提供者加载顺序 #

Laravel中服务提供者的加载顺序会影响路由和中间件的初始化状态。默认情况下自定义服务提供者可能在RouteServiceProvider之前加载，导致auth中间件依赖的认证配置未完全就绪。

打开config/app.php，将你的自定义服务提供者移至App\Providers\RouteServiceProvider::class之后，确保路由在核心路由服务初始化完成后再定义。

2. 延迟路由定义至应用启动完成 #

在自定义服务提供者的boot方法中，使用$this->app->booted()回调延迟路由定义，确保所有服务和中间件都已初始化完成：

public function boot()
{
    $this->app->booted(function () {
        Route::prefix($this->prefix)
            ->middleware('auth')
            ->group(app_path($this->module_path. '/Routes/route.php'));
    });
}

3. 检查认证中间件重定向配置（可选） #

如果需要自定义重定向地址，可修改app/Http/Middleware/Authenticate.php中的redirectTo方法，但此操作仅改变重定向目标，无法解决自定义服务提供者特有的触发问题：

protected function redirectTo($request)
{
    if (! $request->expectsJson()) {
        return route('login'); // 替换为你需要的重定向路由
    }
}

内容的提问来源于stack exchange，提问作者Marco Aurélio Lima Fernandes