db::connect()传错键名会导致connection not found；迁移命令必须显式指定--connection参数，且键名须全小写、无点号、不含大写字母；多库需独立配置与执行迁移文件。
Db::connect() 传错键名会导致 Connection not found
迁移命令执行前，必须确保所有目标数据库连接已在 config/database.php 的 connections 数组中正确定义，且键名全小写、无点号、不含大写字母。例如定义了 'log_db'，就不能在迁移命令里写 --connection=LogDB 或 --connection=log.db，否则直接报错 Connection not found: xxx。
常见错误现象：
- 执行
php think migrate:run --connection=log_db报错，但log_db确实在配置里 —— 检查是否漏写了'type' => 'mysql'，框架靠这个字段加载驱动，缺了会当成无效连接忽略 - 多个连接共用同一 host 和 port，但数据库名或用户权限不同 —— 必须为每个连接单独配
database、username、password，不能复用主库凭据
迁移命令必须显式指定 --connection 参数
ThinkPHP 默认只对 default 连接执行迁移，即使你已配置了 mysql_master 和 mysql_slave，不加 --connection 就不会动从库或日志库。迁移不是“全局广播”，而是单连接定向操作。
实操要点：
- 初始化迁移表：运行
php think migrate:install --connection=log_db，该命令会在log_db中建migration表 - 执行迁移文件：用
php think migrate:run --connection=mysql_slave，它只影响mysql_slave对应的数据库 - 回滚某库变更：用
php think migrate:rollback --connection=report_db -n=1，-n指定步数，不加则回滚全部 - 查看某库迁移状态：用
php think migrate:status --connection=backup_db，确认哪些已执行、哪些待跑
多库迁移不能自动跨库建外键或 JOIN 表
迁移脚本本质是单连接 PDO 操作，up() 方法里写的 $this->table('user')->addColumn('tenant_id', 'integer') 只作用于当前连接的数据库。你无法在一个迁移文件里同时给 main_db.user 加字段、又给 log_db.event 加索引 —— 那需要两个独立迁移文件，分别绑定不同 --connection 执行。
容易踩的坑：
- 误以为
php think migrate:run会遍历所有 connections —— 不会，它只跑 default；想批量操作得写 shell 脚本循环调用 - 在
up()里执行跨库 SQL（如INSERT INTO main_db.user SELECT * FROM log_db.backup_user）—— MySQL 层面可能报错ERROR 1146 (42S02): Table 'log_db.backup_user' doesn't exist，因为当前连接根本看不到另一库 - 用同一个迁移文件管理分库分表结构，结果上线时只跑了主库，从库结构遗漏 —— 必须为每个目标库准备专属迁移文件或严格记录执行日志
env() 变量无法嵌套，多库配置需手动拼接
.env 文件不支持数组语法，像 DATABASE_LOG.HOSTNAME=192.168.1.20 是无效的。所有多库参数必须扁平化定义，再在 database.php 中用 env() 拼进对应连接配置。
正确做法示例：
-
.env写：log_db_hostname=192.168.1.20、log_db_database=app_log、log_db_username=log_ro -
config/database.php中：'log_db' => [ 'type' => 'mysql', 'hostname' => env('log_db_hostname', '127.0.0.1'), 'database' => env('log_db_database', 'thinkphp_log'), ... ] - 迁移命令仍用
--connection=log_db，框架会自动取环境变量补全配置
漏掉这一步，迁移时会连到默认 localhost，但实际日志库在远端服务器，导致结构变更错库、数据丢失风险极高。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
