Flyway

面向研发、实施和运维。完整规则与同事拉代码处理见 monorepo oars-java/oars-migration/README.md。

当前配置

• spring.flyway.enabled=true
• baseline-on-migrate=true
• baseline-version=20260428193000
• out-of-order=true
• locations=classpath:db/migration

检查 SQL

SELECT installed_rank, version, description, type, success
FROM flyway_schema_history
ORDER BY installed_rank;

正常收敛后的已有库可能只有一条 20260428193000 baseline 记录；新库会执行 baseline SQL。

排错要点

• 校验失败且提示旧 V1.x 脚本：通常是历史表残留旧开发期迁移记录（处理步骤见 L2 README「同事拉代码后怎么处理」）。
• 多人新增脚本冲突：调整未执行脚本的时间戳，保证版本号全库唯一。
• 已执行脚本发现问题：新增后续修复脚本，不改历史脚本。
• 合并分支后补跑较早脚本：当前允许 out-of-order=true。
• 表单 physical 相关 DDL 业务规则见 docs/form-designer-architecture.md §13.13（L1），Flyway 通用纪律仍以 L2 README 为准。

生产库清理 flyway_schema_history 务必在确认备份和评估影响范围后执行。

L2 详细说明（monorepo）

主题	文档
Flyway 基线、命名、生产修复	oars-java/oars-migration/README.md
应用 Flyway 配置项	oars-java/CONFIG.md