本文介绍如何通过配置用户模型的数据库连接，实现 laravel 认证系统（auth）使用独立数据库存储用户数据，适用于多数据库架构场景。
本文介绍如何通过配置用户模型的数据库连接，实现 laravel 认证系统（auth）使用独立数据库存储用户数据，适用于多数据库架构场景。
在 Laravel 中，config/auth.php 文件本身并不直接定义数据库连接——它只负责指定用于认证的“用户提供者”（如 EloquentUserProvider）以及对应的用户模型类（默认为 App\Models\User::class）。因此，要让用户数据存入另一个数据库，关键在于修改用户模型（如 User）所使用的数据库连接，而非改动 auth.php。
✅ 正确做法：在用户模型中指定连接
打开你的用户模型文件（通常为 app/Models/User.php），在类定义中设置 $connection 属性：
config/database.php
-
不要修改
config/auth.php中的'provider'或'model'以外的数据库相关字段：该文件无connection或database配置项，强行添加无效。 -
迁移需指向正确连接：运行迁移时，使用
--database=mysql_secondary参数，例如：php artisan migrate --database=mysql_secondary
-
中间件与守卫不受影响：Laravel 的
auth中间件和web/api守卫会自动通过模型读取连接，无需额外配置守卫。 -
关系查询也继承连接：若
User模型关联其他模型（如posts），这些关联默认仍走主连接；如需统一，需为关联模型也显式指定$connection。
✅ 验证是否生效
可在 Tinker 中快速验证：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
php artisan tinker
>>> App\Models\User::on('mysql_secondary')->count();
// 应返回 secondary 数据库中的用户数量
>>> auth()->loginUsingId(1); // 尝试登录，确认从 secondary 库加载用户
通过以上配置，Laravel 认证系统将无缝使用指定数据库存储和查询用户，既保持框架约定，又满足多库隔离需求。
