thinkphp8多数据库连接必须在config/database.php的connections数组中预定义多个唯一小写键名的独立连接，每个连接须显式声明type等完整参数并执行php think clear:config清除缓存；运行时通过db::connect('键名')动态调用，不可依赖.env全局切换或传数组/dsn。
您在ThinkPHP8项目中需要同时操作多个数据库，例如主库读写、从库只读或跨业务系统同步数据，必须在配置层面显式定义多个独立连接，不能靠改.env动态切换——因为.env是全局生效的，改一次就全库跟着变。
在config/database.php中定义多个命名连接
这是官方推荐的标准做法，所有连接都预定义在config/database.php的connections数组内，键名需唯一、小写、不含点号或大写字母；每个连接必须显式声明type字段，否则框架无法识别驱动类型。
第一步：打开config/database.php文件，定位到'connections'配置项。
第二步：在'connections'数组中新增至少两个键值对，例如'mysql_master'和'mysql_slave'。
第三步：为每个连接完整填写'type'、'hostname'、'database'、'username'、'password'等必要参数，不可省略任何一项。缺一个字段，Db::connect()调用时就会fallback到default连接且不报错，导致查表失败却找不到原因。
第四步：确保各连接的'type'值准确匹配目标数据库类型，如mysql、pgsql或sqlsrv，传错将导致Class 'PDO' not found等致命错误。
第五步：保存文件后，执行php think clear:config清除配置缓存，使新配置立即生效。不执行这一步，新连接名在代码里始终报Connection not found。
通过Db::connect()动态加载指定连接
该方法用于运行时按需获取特定数据库连接实例，返回一个独立的Query对象，不改变全局默认连接；参数必须为配置文件中已定义的连接键名，而非数据库名或模型名。
方法一：调用Db::connect('mysql_slave')，其中mysql_slave为database.php中定义的合法键名。
方法二：检查是否抛出Connection not found: mysql_slave异常，若出现则说明键名拼写错误或未在配置中声明。
方法三：使用返回的Query对象执行查询，例如Db::connect('mysql_slave')->table('user_log')->select()。这一步操作起来很简单，直接把查询链写在connect()后面就行。
注意：别在.env里写DB_SLAVE=[]这类数组结构，.env只支持扁平键值对，这种写法会被完全忽略，database.php里对应字段会 fallback 到默认值。
利用.env实现环境级多库参数分离
当不同部署环境（开发/测试/生产）需使用不同数据库地址或凭据时，应借助.env文件进行变量注入，database.php中通过env()函数读取并提供默认值，确保配置可移植且安全。
① 在项目根目录创建UTF-8无BOM格式的.env文件，并写入形如DB2_HOST=127.0.0.1、DB2_NAME=test2的变量。
② database.php的connections数组里补全mysql2配置项，每个字段都用env('DB2_XXX')，例如'hostname' => env('DB2_HOST', '127.0.0.1')。
③ 连接时不能写Db::name('user')->connect('mysql2')，必须先获取Query实例：$db2 = Db::connect('mysql2'); $db2->name('user')->select();。漏掉赋值这一步，后续调用会走默认连接。
④ 变量名必须严格大写+下划线：DB2_PASS有效，DB2_PASSWORD或db2_pass全部无效。
⑤ .env里密码含@、/、:会连不上MySQL，必须手动URL编码，例如pa@ss/word → pa%40ss%2Fword。Navicat能连不代表TP8能解析，TP8是纯字符串拼接DSN。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
