Laravel 9多数据库连接配置后仅访问首个数据库问题排查

核心问题：尽管在User模型中指定了protected $connection = 'mysql2'，但保存用户时仍尝试访问默认数据库dbaseone，以下是针对性解决步骤：

1. 确认数据库连接配置正确性 #

检查config/database.php中mysql2的配置是否正确关联.env参数，确保没有拼写错误：

// config/database.php
'connections' => [
    'mysql' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'dbaseone'),
        'username' => env('DB_USERNAME', 'root'),
        'password' => env('DB_PASSWORD', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        // 其他默认配置
    ],
    'mysql2' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST_2', '127.0.0.1'),
        'port' => env('DB_PORT_2', '3306'),
        'database' => env('DB_DATABASE_2', 'numbertwodbase'),
        'username' => env('DB_USERNAME_2', 'root'),
        'password' => env('DB_PASSWORD_2', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        // 保持与mysql配置一致的其他参数
    ],
],

同时确认.env中DB_DATABASE_2等参数确实指向numbertwodbase。

2. 修正认证系统的数据库连接 #

Laravel认证组件默认使用默认数据库连接查询用户，需修改config/auth.php的用户provider，明确指定mysql2连接：

// config/auth.php
'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
        'connection' => 'mysql2', // 新增此行，指定认证用连接
    ],
],

这是关键步骤，认证逻辑会优先使用provider配置的连接，而非模型的$connection属性。

3. 清除配置缓存 #

若之前执行过php artisan config:cache，修改配置后必须清除缓存才能生效：

php artisan config:clear
php artisan cache:clear

缓存的配置文件会覆盖修改后的内容，这一步不可省略。

4. 检查服务层代码的连接指定 #

查看服务层代码，确保创建/保存用户时未手动指定默认连接：

// 错误示例：手动指定了默认mysql连接
$user = new User();
$user->setConnection('mysql')->fill($data)->save();

// 正确示例：依赖模型的$connection或显式指定mysql2
$user = new User();
$user->fill($data)->save();
// 或
$user = new User();
$user->setConnection('mysql2')->fill($data)->save();

5. 验证模型连接是否生效 #

临时添加代码打印User模型的连接名称，确认配置是否生效：

dd(App\Models\User::getConnectionName());
// 预期输出'mysql2'，若不是则说明模型的$connection被覆盖

若输出不符，检查User模型是否继承了重写getConnectionName()方法的父类，或是否有其他代码动态修改了连接。

6. 确认目标数据库表存在 #

直接通过MySQL命令行或工具验证numbertwodbase中是否存在users表：

USE numbertwodbase;
SHOW TABLES LIKE 'users';

完成以上步骤后重新测试用户保存操作，即可正确使用mysql2连接访问目标数据库。

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