Laravel10多租户环境下替换Breeze认证模型为Account的问题

你的核心问题在于直接覆盖web guard的全局配置无法在所有请求阶段生效，尤其是登出操作时，Laravel可能已经提前初始化了默认的web guard实例，导致仍使用User模型。以下是针对性的解决方案：

1. 修正中间件逻辑：设置默认Guard而非替换配置 #

不要直接修改config/auth.php中的web guard配置，而是在租户请求周期内将默认认证Guard设为tenant：

class SwitchAuthModel
{
    public function handle(Request $request, Closure $next): Response
    {
        // 为当前请求设置默认认证Guard为tenant
        auth()->setDefaultDriver('tenant');
        return $next($request);
    }
}

2. 修改Breeze认证逻辑：明确指定使用tenant Guard #

Breeze的默认认证代码会使用web Guard，需要手动修改为tenant Guard：

（1）修改登录请求的认证逻辑 #

编辑app/Http/Requests/Auth/LoginRequest.php的authenticate()方法：

public function authenticate()
{
    $this->ensureIsNotRateLimited();

    // 明确使用tenant Guard进行认证
    if (! auth('tenant')->attempt($this->only('email', 'password'), $this->boolean('remember'))) {
        RateLimiter::hit($this->throttleKey());

        throw ValidationException::withMessages([
            'email' => trans('auth.failed'),
        ]);
    }

    RateLimiter::clear($this->throttleKey());
}

（2）修改登出逻辑 #

编辑app/Http/Controllers/Auth/AuthenticatedSessionController.php的destroy()方法：

public function destroy(Request $request)
{
    // 使用tenant Guard执行登出
    auth('tenant')->logout();

    $request->session()->invalidate();
    $request->session()->regenerateToken();

    return redirect('/');
}

3. 确保Account模型配置正确 #

Account模型必须实现Laravel认证所需的接口和配置：

namespace App\Models\Tenant;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class Account extends Authenticatable
{
    use Notifiable;

    // 指定租户数据库连接（需与config/database.php中的连接名一致）
    protected $connection = 'tenant';

    // 指定对应的数据表
    protected $table = 'accounts';

    // 可填充字段
    protected $fillable = [
        'email',
        'password',
        // 你的其他字段
    ];

    // 隐藏敏感字段
    protected $hidden = [
        'password',
        'remember_token',
    ];

    // 字段类型转换
    protected $casts = [
        'email_verified_at' => 'datetime',
        'password' => 'hashed',
    ];
}

4. 路由分组配置 #

确保所有租户侧的认证路由都包裹在租户中间件组内：

Route::middleware(['tenant', \App\Http\Middleware\SwitchAuthModel::class])->group(function () {
    // 租户登录/登出路由
    Route::get('/tenant/login', [AuthenticatedSessionController::class, 'create'])->name('tenant.login');
    Route::post('/tenant/login', [AuthenticatedSessionController::class, 'store']);
    Route::post('/tenant/logout', [AuthenticatedSessionController::class, 'destroy'])->name('tenant.logout');

    // 其他租户业务路由
});

问题根源说明 #

你之前的方案直接替换web guard的配置，但Laravel的认证服务在请求初始化阶段就已绑定了web guard的实例，登出操作时会复用这个实例，导致仍关联User模型。通过设置默认Guard+明确指定Guard的方式，能确保整个租户请求周期内都使用Account模型进行认证操作。

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