Laravel 9 及以上版本在查询构造器层面支持链式 connection() 方法切换，但配置缺失常引发"SQLSTATE[HY000] [1045] Access denied"错误，需严格执行五步配置流程。

原因分析

Laravel 默认仅加载 config/database.php 中 default 指定的单一连接，若未在 connections 数组注册新键名，即使.env 已修改，框架仍无法识别新数据源。根据 2026 年 4 月 17 日收录的技术文档，所有连接均需显式引用，Laravel 不自动推断角色，常见错误是只改了.env 里的 DB_DATABASE 却没在配置文件中新增对应连接块。

解决方案

注册命名连接与环境变量

在 config/database.php 的 connections 数组中新增键名，如 mysql_secondary，确保 driver、host 等字段完整。根据 2026 年 1 月 9 日的配置指南，每个连接必须有唯一键名且完整定义驱动及凭证字段。同时在.env 文件中添加独立变量组，例如 DB_SECONDARY_HOST、DB_SECONDARY_DATABASE 等五项核心参数，变量名需与配置文件中 env() 函数调用严格对应。

代码动态切换与缓存清除

使用 DB::connection('mysql_secondary')->table('users')->get() 进行临时切换。需注意 connection() 链式方法仅在 Laravel 9.x+ 版本支持，8.x 需改用 DB::connection() 门面。修改配置后必须运行 php artisan config:clear，否则新变量不会被加载生效，这是 2026 年 4 月 11 日文档中强调的关键步骤。

注意事项

事务跨连接不生效：DB::transaction() 只对当前连接起作用，若在事务内调用 DB::connection('b')，后者不在事务保护内，MySQL 本身也不支持跨库事务。此外，避免硬编码连接名，推荐在 AppServiceProvider 中绑定服务标识，防止散落在各处难维护。

参考来源

来源：Laravel 架构文档 - Laravel 如何配置多数据库连接_Laravel 配置多数据库连接方法【架构】

来源：Laravel 数据库教程 - 如何在 Laravel 中配置多个数据库连接？(动态切换技巧)

来源：Laravel 总结 - Laravel 怎么配置多数据库_Laravel 怎么切换数据库连接【总结】