本文介绍如何通过修改用户模型的数据库连接，使 laravel 认证系统（auth）使用与其他业务表不同的数据库，适用于多数据库架构场景。
本文介绍如何通过修改用户模型的数据库连接，使 laravel 认证系统（auth）使用与其他业务表不同的数据库，适用于多数据库架构场景。
在 Laravel 中，config/auth.php 文件本身并不直接配置数据库连接——它只定义认证驱动（如 eloquent 或 database）、用户模型路径、密码重置表名等逻辑配置。真正的数据库连接控制发生在 Eloquent 模型层。因此，要让 User 模型（即认证所依赖的用户数据源）使用独立数据库，需在对应的 Eloquent 模型中显式指定连接。
✅ 正确做法是在 app/Models/User.php（Laravel 9+ 默认路径）中设置 $connection 属性：
<?php
namespace App\Models;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
// 指向 config/database.php 中定义的另一个数据库连接名
protected $connection = 'mysql_secondary';
// 可选：若该库中用户表名不同，可同时指定
protected $table = 'users';
}⚠️ 前提条件：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 确保
config/database.php中已正确定义目标连接（如mysql_secondary），包含host、database、username等完整配置； - 若使用数据库读写分离或多租户连接池，请确保该连接在运行时可用且具备
SELECT/INSERT/UPDATE权限； - 修改后请清空配置与路由缓存：
php artisan config:clear和php artisan cache:clear。
? 扩展提示：
- 若项目中存在多个认证模型（如
Admin、Customer），可为每个模型单独配置protected $connection； - 不建议通过重写
Auth::provider()或手动修改auth.php中的model路径来绕过模型层连接控制——这违背 Laravel 的契约设计，易引发序列化、守卫切换等异常； - 对于 API 认证（如 Sanctum、Passport），该配置同样生效，因其底层仍依赖
User::findForPassport()等模型方法。
总之，Eloquent 模型的 $connection 属性是 Laravel 多数据库认证的核心控制点——简洁、可靠、符合框架约定。
