Flyway可重复迁移：如何记录现有对象校验和至历史表且不执行

首先明确：flyway repair不是用来实现你需求的工具。它的核心作用是修复flyway_schema_history表中与本地迁移文件的不一致问题（比如校验和不匹配、手动删除的迁移记录恢复），无法直接帮你将现有数据库对象标记为已执行的可重复迁移。

你之前操作的问题分析 #

1. 手动插入NULL校验和后执行repair：repair不会自动计算并填充空校验和，它只处理已存在的、与本地文件校验和不匹配的记录，不会主动补全空值。
2. 先执行SELECT 1;再替换为函数DDL：此时Flyway已经记录了该可重复迁移的初始校验和（对应SELECT 1;），修改文件后执行repair，Flyway不会自动更新历史记录的校验和——因为repair不会将已执行的迁移记录关联到新的文件内容，后续执行migrate时，Flyway发现校验和不匹配，就会重新执行该迁移，这是可重复迁移的正常逻辑，但不符合你的需求。

正确实现步骤 #

要让现有函数/视图成为可重复迁移，且首次migrate不执行，仅标记为已执行，按以下步骤操作：

1. 创建对应可重复迁移文件
   针对每个已存在的函数/视图，创建R__<功能描述>_<对象名>.sql格式的文件，内容为该对象的完整DDL（比如CREATE OR REPLACE FUNCTION ...或CREATE OR REPLACE VIEW ...）。

2. 计算文件的Flyway校验和
   执行flyway info命令，Flyway会扫描本地迁移文件并输出每个文件的校验和，找到你刚创建的R文件对应的校验和，记下来。

3. 手动插入历史记录
   直接向flyway_schema_history表插入记录，模拟该可重复迁移已执行完成：

   INSERT INTO flyway_schema_history (
       installed_rank, version, description, type, script, checksum, installed_by, installed_on, execution_time, success
   ) VALUES (
       -- 自动获取当前最大的installed_rank并加1，保证顺序正确
       (SELECT COALESCE(MAX(installed_rank), 0) + 1 FROM flyway_schema_history),
       NULL, -- 可重复迁移没有version字段
       '<填写描述，比如Create_User_Get_Function>',
       'REPEATABLE',
       'R__<功能描述>_<对象名>.sql', -- 要和实际文件名完全一致
       <你刚才记录的校验和>, -- 必须和本地文件的校验和完全匹配
       '<你的数据库登录用户名>',
       NOW(),
       0, -- 执行时间填0即可
       TRUE -- 标记为执行成功
   );
   

   注意：如果有多个可重复迁移文件，按顺序逐个插入，保证installed_rank递增。

4. 验证并执行migrate

   • 执行flyway info，确认这些可重复迁移的状态为Success，且校验和与本地文件一致。
   • 执行flyway migrate，Flyway会检查校验和，若与历史记录匹配则不会重复执行；后续如果修改了R文件的内容，校验和变化，migrate时会自动重新执行该迁移，符合可重复迁移的预期。

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