多租户Laravel应用中如何动态修改Auth认证使用的数据库连接

下面是三种经过验证的可行方案，可根据你的业务场景选择：

方案1：动态修改Auth用户提供者配置 #

Laravel的用户认证底层会读取auth.providers.users.connection配置项作为用户表的数据库连接，你可以在租户切换完成后，动态修改该配置：

// 第一步：先注册租户对应的数据库连接（如果还没注册的话）
Config::set('database.connections.tenant_custom', [
    'driver' => 'mysql',
    'host' => $currentTenant->db_host,
    'database' => $currentTenant->db_name,
    'username' => $currentTenant->db_user,
    'password' => $currentTenant->db_password,
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
]);

// 第二步：清空旧连接缓存，避免复用之前的连接
DB::purge('tenant_custom');

// 第三步：修改Auth用户提供者的默认连接
Config::set('auth.providers.users.connection', 'tenant_custom');

// 之后调用loginUsingId就会自动走租户的数据库
$loginResult = Auth::loginUsingId($targetUserId);

这个方案适合整个请求生命周期内都需要使用租户连接的场景，修改后所有Auth相关的用户查询都会走指定连接。

方案2：手动查询租户用户后直接登录 #

如果你不想修改全局配置，或者只需要单次切换连接做登录，可以绕过loginUsingId，先在指定连接下查询到用户实例，再调用Auth的login方法直接登录：

// 直接指定连接查询对应用户
$targetUser = User::on('tenant_custom')->find($targetUserId);

if ($targetUser) {
    // 直接登录用户实例，不需要走Auth默认的用户查询逻辑
    Auth::login($targetUser);
    // 后续业务逻辑
}

这个方案灵活性最高，不会影响全局的Auth和User模型配置，适合临时切换连接的场景。

方案3：全局绑定User模型的默认连接 #

如果你的多租户逻辑是通过中间件识别租户，整个请求内都需要使用租户连接，可以在租户识别完成后，全局设置User模型的默认连接：

// 租户识别中间件的handle方法内
public function handle(Request $request, Closure $next)
{
    $currentTenant = $this->getTenantByRequest($request); // 你自己的租户识别逻辑
    
    // 注册租户连接、清空缓存的逻辑和方案1一致
    Config::set('database.connections.tenant_custom', $currentTenant->db_config);
    DB::purge('tenant_custom');
    
    // 全局设置User模型的默认连接
    User::setDefaultConnection('tenant_custom');
    
    return $next($request);
}

设置完成后，整个请求内所有User模型的查询、Auth的相关操作都会默认走租户连接，不需要再额外手动指定。

• 后续请求从Session恢复登录状态时，也需要先执行租户连接切换逻辑，否则Laravel会用默认连接查询用户，导致找不到用户的报错。
• 如果配置修改后不生效，可以先清空配置缓存：php artisan config:clear，测试阶段不要开启配置缓存。

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