实体新增列与Flyway迁移的执行顺序及数据填充咨询

• 核心结论：Flyway不会自动识别你实体类新增的列，它和ORM（比如JPA/Hibernate）的自动表结构更新是完全独立的两套机制。程序启动时，不会先帮你新增列再执行迁移。

• 为什么会踩坑？
  如果你的项目依赖ORM的ddl-auto=update来自动同步实体到数据库，Flyway的迁移执行顺序默认是在ORM自动更新之前。这时候直接跑带INSERT的迁移文件，数据库里还没新增列，肯定会报“列不存在”的错误。就算你调整配置让ORM先跑，这种混合模式也极不推荐——Flyway的核心价值就是管控schema变更的一致性和可追溯性，ORM自动更新很容易导致schema混乱。

• 正确做法：把新增列和数据填充放在同一个迁移文件里，先执行schema变更，再插入数据。
  比如创建一个符合Flyway命名规范的SQL迁移文件（如V2__add_new_column_and_fill_data.sql）：

  -- 先新增列，加IF NOT EXISTS避免重复执行报错（不同数据库语法略有差异，比如MySQL用IF NOT EXISTS，Oracle需用对应写法）
  ALTER TABLE your_target_table ADD COLUMN new_param VARCHAR(255) DEFAULT NULL;
  
  -- 执行数据填充逻辑，也可根据需求用UPDATE批量设置默认值
  INSERT INTO your_target_table (id, new_param) 
  VALUES 
      (1, 'default_value_1'),
      (2, 'default_value_2');
  

• 额外提醒：

  • 所有schema变更（加列、改字段类型等）都应该通过Flyway迁移文件来做，彻底关掉ORM的自动更新（比如ddl-auto=none），这样才能保证数据库结构的变更完全可控、可追溯。
  • 如果是给已有数据批量设置默认值，用UPDATE语句更合适：UPDATE your_target_table SET new_param = 'default' WHERE new_param IS NULL;

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