如何基线化SQL脚本使其不显示在Flyway待执行迁移列表中

核心逻辑 #

Flyway社区版的flyway baseline命令不会自动生成基线脚本，它仅在flyway_schema_history表中插入一条基线记录，标记当前数据库状态对应某个版本号（默认是1）。你遇到的脚本仍在待执行列表的问题，本质是脚本版本号与基线版本不匹配，或脚本命名不符合Flyway规则。

具体解决步骤 #

1. 严格遵循脚本命名规范
   Flyway迁移脚本必须使用V<版本号>__<描述>.sql格式，比如V1__baseline_initial_schema.sql。如果命名错误（比如少双下划线、版本号格式不对），Flyway会将其识别为待执行脚本。

2. 对齐基线版本与脚本版本

   • 若执行flyway baseline用了默认版本（1），手动生成的脚本版本号必须为1，文件名对应V1__xxx.sql。
   • 执行基线时可主动指定版本号，命令示例：

     flyway baseline -baselineVersion=1 -baselineDescription="Initial database schema"
     

   确保脚本版本号和基线版本完全一致。

3. 手动标记脚本为已执行
   若已完成基线操作，且脚本版本与基线版本匹配，但脚本仍在待执行列表，可直接在flyway_schema_history表中插入记录标记脚本已执行：

   • 记录需包含：version（与脚本版本一致）、description（脚本描述）、type（填SQL）、script（脚本文件名）、checksum（可通过flyway info命令获取脚本校验值）、installed_by（执行命令的数据库用户）、installed_on（当前时间）、execution_time（填0）、success（填true）。
   • 也可以先移除待执行脚本，重新执行flyway baseline，确保基线记录与当前数据库状态完全匹配。

4. 验证基线状态
   执行flyway info命令，查看输出中的基线版本和脚本状态，确认基线对应版本显示为Baseline，且手动脚本不再出现在待执行列表中。

注意事项 #

• Flyway社区版无自动生成基线脚本的功能，所有基线脚本需手动导出数据库结构后，按命名规范修改文件名。
• 后续迁移脚本的版本号必须高于基线版本，否则会被识别为重复或待执行脚本。

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