本文介绍如何通过修改用户模型的数据库连接，实现 laravel 认证系统（auth）使用独立数据库存储用户数据，适用于多数据库架构场景。

本文介绍如何通过修改用户模型的数据库连接，实现 laravel 认证系统（auth）使用独立数据库存储用户数据，适用于多数据库架构场景。

在 Laravel 中，config/auth.php 文件本身不直接定义数据库连接，它只负责指定用于认证的“用户提供者”（如 EloquentUserProvider）及其对应的 Eloquent 模型类（默认为 App\Models\User::class）。因此，要让用户数据存储在另一个数据库中，关键在于配置用户模型所使用的数据库连接，而非修改 auth.php。

✅ 正确做法：在 User 模型中指定连接

打开 app/Models/User.php（Laravel 9+ 默认路径），在模型类中设置 $connection 属性：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

config/database.php

• ❌ 不要尝试在 config/auth.php 中添加数据库配置——该文件不支持 connection 字段，Laravel 会忽略。
• ✅ 所有基于 User 模型的 Auth 操作（如 Auth::attempt()、Auth::user()、$request->user()）将自动使用该模型指定的连接。
• ? 若你使用了自定义认证模型（如 AdminUser 或 Customer），同样需在其对应模型中设置 protected $connection。
• ? 运行 php artisan tinker 测试连接是否生效：

  >>> App\Models\User::on('mysql_secondary')->count()
  => 123
  >>> App\Models\User::count() // 使用模型默认连接（即 mysql_secondary）
  => 123

✅ 总结

Laravel 认证系统的数据库归属由用户模型决定，而非 auth.php 配置。只需在 User 模型中声明 protected $connection，即可无缝切换用户数据源，完全兼容多数据库部署需求。此方式简洁、可靠，且符合 Laravel 的契约设计原则。