Laravel使用stancl/tenancy切换租户时跳转至登录页问题

我在Laravel项目中使用"stancl/tenancy": "^3.9"，登录后可正常跳转至租户页面，但尝试切换至其他租户时，会因会话过期被重定向到登录页面。

相关代码 #

租户切换控制器方法 #

// Controller method
public function switchClinic(Request $request)
{
    $request->validate([
        'tenant_switch' => 'required',
    ]);

    if($request->tenant_switch) {
       $tenant = \App\Models\Tenant::findOrFail($request->tenant_switch);
       tenancy()->initialize($tenant);
       
       $tenantUser = User::where('email', session('email'))->first();

        if ($tenantUser) {
            backpack_auth()->login($tenantUser);
        }

        return redirect()->route('tenant.dashboard', ['tenant' => $request->tenant_switch]);
    }

    return redirect()->back();
}

租户路由配置 #

// web.php
Route::group([
 'prefix' => config('tenancy.tenant_route') .'/{tenant}',
 'middleware' => [
    InitializeTenancyByPath::class,
    'web',
    'admin'
  ],
], function () { });

登录控制器代码 #

class LoginController extends BackpackLoginController
{
  public function login(Request $request)
  {
   // more code here
   }


protected function authenticated(Request $request, $user)
{ 

    $clinic = $user->clinics->first();
    session(['tenant_id' => $clinic?->tenant_id, 'email' => $user->email, 'clinic_id' => $clinic?->id]);

    if($clinic) { 
       $tenant = \App\Models\Tenant::findOrFail($clinic?->tenant_id);
       tenancy()->initialize($tenant);

        $tenantUser = User::where('email', $user?->email)->first();

        if ($tenantUser) {
            backpack_auth()->login($tenantUser);
        }

        return redirect()->route('tenant.dashboard', ['tenant' =>  $clinic?->tenant_id]); //->intended(tenant_url('/'));
    }

    return redirect('/');
}

问题原因及解决方案 #

1. 调整租户路由中间件顺序 #

租户路由中web中间件负责初始化会话，必须放在InitializeTenancyByPath::class之前，否则会话无法正确关联到租户环境，导致登录状态丢失。

修改后的路由：

// web.php
Route::group([
 'prefix' => config('tenancy.tenant_route') .'/{tenant}',
 'middleware' => [
    'web',
    InitializeTenancyByPath::class,
    'admin'
  ],
], function () { });

2. 迁移租户切换路由到中央系统 #

租户切换操作需要在中央系统（非租户前缀路由）中执行，避免提前初始化当前租户导致冲突。给switchClinic方法配置中央路由：

// web.php 中央系统路由区域
Route::post('/switch-clinic', [YourController::class, 'switchClinic'])->middleware(['web', 'admin']);

3. 优化租户切换逻辑 #

确保从中央系统获取当前登录用户，初始化租户后登录对应租户用户并更新会话信息，同时开启会话持久化：

public function switchClinic(Request $request)
{
    $request->validate([
        'tenant_switch' => 'required',
    ]);

    // 验证中央系统用户登录状态
    $centralUser = backpack_auth()->user();
    if (!$centralUser) {
        return redirect()->route('login');
    }

    $tenant = \App\Models\Tenant::findOrFail($request->tenant_switch);
    tenancy()->initialize($tenant);
    
    // 查找租户数据库中对应用户
    $tenantUser = User::where('email', $centralUser->email)->first();

    if ($tenantUser) {
        // 登录租户用户并维持会话
        backpack_auth()->login($tenantUser, true);
        // 更新会话中的租户相关信息
        session([
            'tenant_id' => $tenant->id,
            'clinic_id' => $tenantUser->clinics->first()?->id
        ]);
    } else {
        return redirect()->back()->withErrors('该租户下无此用户权限');
    }

    return redirect()->route('tenant.dashboard', ['tenant' => $tenant->id]);
}

4. 检查admin中间件逻辑 #

确保admin中间件验证的是当前租户环境中的用户，而非中央系统用户：

public function handle(Request $request, Closure $next)
{
    if (!backpack_auth()->check()) {
        return redirect()->route('login');
    }

    // 根据业务逻辑验证用户权限
    if (!backpack_auth()->user()->isAdmin()) {
        abort(403);
    }

    return $next($request);
}

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