Laravel Migrations Generator 多数据库表结构导出问题解析

问题背景

在使用 Laravel Migrations Generator 工具时，当开发者连接了多个数据库并希望仅针对特定数据库生成迁移文件时，工具会默认导出所有数据库的表结构，而非仅目标数据库的表结构。这显然不符合预期行为，也给开发者带来了不必要的麻烦。

技术分析

通过查看工具源码，我们发现问题的根源在于 SQL 查询语句的设计。当前实现中，查询语句仅排除了系统数据库（如 information_schema、mysql 等），但没有针对用户指定的目标数据库进行过滤：

SELECT 
    table_name AS `name`, 
    table_schema AS `schema`, 
    (data_length + index_length) AS `size`, 
    table_comment AS `comment`, 
    engine AS `engine`, 
    table_collation AS `collation` 
FROM 
    information_schema.tables 
WHERE 
    table_type IN ('BASE TABLE', 'SYSTEM VERSIONED') 
    AND table_schema NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys') 
ORDER BY 
    table_schema, 
    table_name

解决方案

正确的做法应该是修改 WHERE 子句，使用 table_schema IN 条件来明确指定目标数据库，而非仅排除系统数据库。改进后的查询示例如下：

SELECT 
    TABLE_NAME AS `name`, 
    table_schema AS `schema`, 
    (data_length + index_length) AS `size`, 
    table_comment AS `comment`, 
    ENGINE AS `engine`, 
    table_collation AS `collation`
FROM 
    information_schema.tables
WHERE 
    table_type IN ('BASE TABLE', 'SYSTEM VERSIONED') 
    AND table_schema IN ('your_target_database')
ORDER BY 
    table_schema, 
    TABLE_NAME

实现建议

1. 参数设计：工具应新增一个 --db 或 --database 参数，允许用户指定目标数据库名称。

2. 逻辑优化：

   • 当用户指定数据库参数时，使用 table_schema IN 条件精确筛选
   • 未指定参数时，保持现有行为（排除系统数据库）

3. 兼容性考虑：确保修改后的查询在不同数据库版本上都能正常工作

最佳实践

对于需要在多数据库环境中使用此工具的开发者，建议：

1. 明确指定目标数据库名称，避免意外导出其他数据库的表结构
2. 定期检查生成的迁移文件，确保只包含预期的表结构
3. 在开发环境中测试生成的迁移文件，确认其行为符合预期

总结

Laravel Migrations Generator 工具的这一改进将显著提升其在多数据库环境下的可用性，使开发者能够更精确地控制迁移文件的生成范围。通过简单的 SQL 查询调整和新增参数支持，即可解决当前的问题，为开发者提供更好的使用体验。