Flyway迁移后表无列、迁移忽略及顺序混乱问题求助

1. 为何创建的表没有列？ #

• pgAdmin缓存未刷新：刚完成迁移就查看时，pgAdmin的对象列表可能未自动更新，右键点击public schema或目标表，选择Refresh后再查看。
• 脚本未正确执行：
  1. 登录Docker中的PostgreSQL容器，执行psql -d reputations进入数据库，手动运行迁移脚本，验证是否能创建带列的表。
  2. 查看Flyway自动生成的schema_version表，确认对应迁移记录的state字段为success，若为failed则说明脚本执行过程中出错。
• 数据库连接配置错误：检查pom.xml中Flyway插件的数据库URL，确认是否连接到Docker部署的reputations数据库（比如端口映射是否正确，避免连接到本地其他PostgreSQL实例）。
• 权限问题：确认Flyway使用的数据库用户拥有CREATE TABLE和定义列的权限（虽然能创建表大概率权限没问题，但可执行GRANT ALL ON SCHEMA public TO <your-user>验证）。

2. 最后一个迁移脚本为何被忽略？ #

• 脚本命名不符合Flyway规范：Flyway要求版本迁移脚本必须遵循V<版本号>__<描述>.sql格式（注意是双下划线），比如V1__create_person_table.sql。若命名错误（如单下划线、小写v、无版本号），Flyway会将其识别为未管理脚本而忽略。
• 脚本已被标记为已执行/缺失：查看schema_version表，若对应脚本的记录已存在，可能是之前执行过脚本后又修改了内容，Flyway默认禁止修改已执行的脚本；若记录状态为missing，则说明脚本曾被执行后被删除，重新添加后不会再次执行。
• 脚本路径配置错误：检查pom.xml中Flyway插件的<locations>配置，确保指向迁移脚本所在目录（默认是db/migration，若脚本放在其他路径需手动指定）。
• 脚本验证失败：执行mvn flyway:validate，查看是否有脚本语法错误或不符合Flyway规则的问题，验证失败的脚本会被跳过执行。

3. 迁移顺序为何混乱？ #

• 版本号字典序排序问题：Flyway对脚本版本号按字符串字典序排序，而非数字大小。例如V10__xxx.sql会排在V2__xxx.sql前面，因为字符串"10"比"2"小。解决办法是给版本号补前导零，比如V001__xxx.sql、V002__xxx.sql。
• 混合不同类型的迁移脚本：若同时使用版本迁移（V开头）、重复迁移（R开头）或撤销迁移（U开头），不同类型脚本的执行顺序优先级不同，会导致整体顺序混乱。建议统一使用版本迁移脚本。
• 版本号重复或不连续：检查所有脚本的版本号，确保没有重复的版本号，且版本号按递增顺序编排，避免Flyway排序时出现异常。

额外注意事项（Spring Boot + jOOQ场景） #

确认Spring Boot自动配置的Flyway参数与Maven插件的配置一致，避免两者使用不同的数据库连接或脚本路径，导致迁移结果不一致。

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