Flyway可重复迁移显示已安装但数据库未更新问题求助

可能原因及排查步骤 #

• 脚本内容异常
  针对未生效的可重复迁移脚本：

  • 检查插入语句是否存在逻辑问题，比如INSERT ... WHERE NOT EXISTS的条件是否错误，或者目标表存在唯一键约束导致插入被静默忽略（如MySQL的INSERT IGNORE）
  • 确认脚本中是否包含事务控制语句（如ROLLBACK），Flyway默认会为每个迁移包裹事务，手动事务控制可能导致数据未持久化
  • 排查脚本是否有环境分支判断，是否因环境变量匹配问题跳过了插入逻辑

• Flyway 5.2.4版本哈希计算bug
  可重复迁移依赖脚本内容哈希值判断是否需要重跑，该版本存在哈希计算异常的已知案例：

  • 检查未生效脚本的换行符、注释、空白字符是否有特殊格式，尝试移除多余注释、统一换行符后重新执行
  • 手动计算脚本哈希值，和flyway_schema_history表中对应记录的checksum字段对比，若不匹配但Flyway未重跑，说明版本存在哈希校验bug

• 数据库层面问题

  • 查看数据库原生日志（如MySQL慢查询日志、PostgreSQL pg_log），确认该插入语句是否执行、是否有报错被Flyway忽略
  • 验证数据库用户对目标表的插入权限（虽然后续两个脚本生效，但仍需排除权限细分场景）
  • 检查目标表是否存在触发器，是否触发了数据删除或修改逻辑

• Docker挂载异常

  • 进入Docker容器，核对Flyway脚本目录下的未生效脚本内容是否与本地一致，排除挂载缓存或文件映射错误的情况

临时修复方案 #

1. 直接在数据库中手动执行未生效的插入脚本，验证数据是否能正常写入
2. 修改未生效脚本的内容（如添加无意义注释、调整空白字符），触发Flyway重新计算哈希值，强制重跑该迁移

内容的提问来源于stack exchange，提问作者alex.cook