Laravel单库转读写分离配置后迁移报错问题咨询

1. 解决「Database connection [read] not configured.」错误 #

Laravel默认的读写分离是在单个主连接下嵌套配置read/write子节点，read并非独立的顶层连接项。若要通过--database=read指定迁移目标，需调整config/database.php的连接结构：

配置独立只读连接 #

在connections数组中添加独立的read连接：

'connections' => [
    // 主写连接
    'mysql' => [
        'driver' => 'mysql',
        'host' => env('DB_WRITE_HOST', 'localhost'),
        'database' => env('DB_DATABASE'),
        'username' => env('DB_USERNAME'),
        'password' => env('DB_PASSWORD'),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'strict' => true,
    ],
    // 独立只读连接
    'read' => [
        'driver' => 'mysql',
        'host' => env('DB_READ_HOST', 'localhost'),
        'database' => env('DB_DATABASE'),
        'username' => env('DB_READ_USERNAME'), // 必须拥有CREATE/ALTER等DDL权限，只读用户无法执行migrate
        'password' => env('DB_READ_PASSWORD'),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'strict' => true,
    ],
],

后续操作 #

• 执行php artisan config:clear后，重启Docker容器（容器环境下配置缓存可能驻留内存）。
• 确认只读库的数据库用户权限：migrate需要DDL操作权限，只读用户仅拥有SELECT权限的话会报错。

2. 关于migrate目标库的疑问 #

migrate的目标库由--database参数或默认连接决定：

• 不指定--database时，会使用database.php中default配置的连接（通常是主写库），清空主库后migrate仍会在主库执行。
• 指定--database=read且连接配置正确、用户有权限的话，migrate会在只读库执行，但这不符合读写分离的架构设计。

3. 读写分离架构下的正确流程 #

读写分离的核心是主库处理写操作，从库处理读操作，通过数据库自身同步机制（如MySQL主从复制）同步结构和数据，无需手动在从库执行migrate：

1. 所有迁移仅在主写库执行：php artisan migrate（无需指定--database）。
2. 配置数据库主从同步（如MySQL binlog同步），让只读库自动同步主库的表结构和数据。
3. 现有主库数据同步到只读库：可通过mysqldump导出主库数据后导入只读库，或利用主从同步的初始化快照完成。

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