laravel 配多数据库需三步：一在 config/database.php 定义连接（键名小写下划线、env() 读取、charset 统一 utf8mb4）；二在 .env 补环境变量并运行 config:clear；三通过模型 $connection 属性或 on() 方法切换库，迁移、事务等需显式指定 --database 或 connection()。

在 Laravel 里配多数据库，核心就三件事：定义连接、绑定模型或临时切换、注意事务和迁移的特殊处理。不改配置文件、不清理缓存、名字写错或字符集不一致，都可能查着查着就跑回主库了。

一、在 config/database.php 里加新连接

打开 config/database.php，找到 'connections' 数组，在里面新增一个键（比如 'mysql_analytics'），结构和默认的 'mysql' 一样，但所有参数必须指向另一个库：

• 键名必须全小写，只含字母、数字和下划线（mysql2 可以，mysql-2 会报错）
• 每个字段都用 env() 读取，比如 'host' => env('DB_ANALYTICS_HOST')，别硬编码
• 'charset' 和 'collation' 建议统一设为 'utf8mb4' 和 'utf8mb4_unicode_ci'，避免中文乱码或插入失败
• 确认没误删或覆盖默认的 'mysql' 连接——Laravel 内部很多功能（如迁移、通知）依赖它

二、在 .env 里补上对应环境变量

光配 PHP 文件不够，得让 Laravel 知道这些值从哪来。在 .env 文件里加上：

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

• DB_ANALYTICS_HOST=192.168.1.200
• DB_ANALYTICS_DATABASE=analytics_db
• DB_ANALYTICS_USERNAME=analyst
• DB_ANALYTICS_PASSWORD=secret123

改完记得运行 php artisan config:clear，否则缓存会让新配置不生效。

三、模型固定用某个库 or 查询时临时切

两种常用方式，适用场景不同：

• 让整个模型永远走副库：在模型类里加 protected $connection = 'mysql_analytics';，字符串必须和 config/database.php 里的键名**完全一致**（大小写、下划线都不能差）
• 某次查询临时切库：用 User::on('mysql_analytics')->get() 或 DB::connection('mysql_analytics')->table('logs')->get()
• 别在控制器里混着用：比如先 DB::connection(...)->get()，又写 Report::all()——后者仍走默认库，数据对不上还难排查

四、迁移、事务、Observer 这些要单独处理

它们不会自动继承你设的连接，容易踩坑：

• 跑迁移要用 php artisan migrate --database=mysql_analytics，不加 --database 就只动默认库
• 事务只作用于单个连接：DB::connection('mysql_analytics')->transaction(...) 不会影响 mysql 库
• Observer、子查询、DB::raw() 都不自动带连接，得手动指定，比如 SomeModel::on('mysql_analytics')->with(['related' => function ($q) { $q->on('mysql_analytics'); }])