Spring Flyway迁移脚本重基线配置咨询：是否缺失必要配置？

一、现有配置的缺失点 #

你当前仅配置了spring.flyway.baselineOnMigrate = true和spring.flyway.baseline-version=2，这不足以完成无冲突的基线迁移，还需要补充两个关键配置来避免Flyway因缺失旧脚本而报错。

二、必须补充的配置 #

添加以下配置到你的Spring Boot配置文件（application.yml或application.properties）：

• spring.flyway.ignoreMissingMigrations = true：删除V1系列脚本后，Flyway默认会校验历史执行记录与现有脚本的一致性，开启该配置可忽略缺失的旧脚本，防止启动时报错。
• spring.flyway.cleanDisabled = true（强烈建议）：禁用clean命令，避免误操作清空数据库中的现有数据。
• 可选：spring.flyway.baseline-description：设置基线描述，比如"New baseline post V1 migrations cleanup"，方便在schema_version表中识别这条基线记录。

完整的YAML配置示例：

spring:
  flyway:
    baseline-on-migrate: true
    baseline-version: 2
    baseline-description: "New baseline after removing V1 migration scripts"
    ignore-missing-migrations: true
    clean-disabled: true

三、手动操作最少的执行流程 #

1. 清理旧脚本：直接删除src/main/resources/db/migration下所有V1开头的迁移文件，仅保留V2_0_0__baseline.sql。重要提醒：这个基线脚本必须是当前数据库的完整schema快照（即执行完所有V1脚本后的最终结构），确保基线能匹配现有数据库状态。
2. 启动应用：Spring Boot启动时，Flyway会自动完成以下操作：
   • 检查schema_version表，若不存在基线记录，自动插入版本为2的基线条目。
   • 因开启了ignoreMissingMigrations，不会因找不到V1脚本而抛出异常。
   • 后续新增的迁移脚本可从V2_1_0__xxx.sql开始编写。

四、关键注意事项 #

• 基线脚本的准确性直接决定后续迁移的稳定性，务必确保V2_0_0__baseline.sql与当前数据库的结构完全一致。
• baseline-version=2要与脚本的版本前缀V2_0_0对应，Flyway会按数字段解析版本号，主版本号匹配即可。
• 先在测试环境验证流程，确认schema_version表中成功新增版本2的基线记录，且应用运行正常后，再部署到生产环境。

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