Flyway前序迁移脚本变更无法被后续脚本识别的问题求助

可能的原因 #

• Spring Data EntityManager缓存未同步：Java迁移脚本通过Spring Data操作数据库后，EntityManager的一级缓存会保留旧数据，后续脚本读取时可能直接取缓存而非数据库最新状态。
• 事务边界不一致：混合使用SQL脚本（JDBC直接执行）和Java脚本（Spring Data）时，两者的事务管理边界不匹配，导致前序变更未被及时提交到数据库。
• Flyway与Spring事务上下文冲突：Java迁移脚本中如果使用了Spring的事务传播行为，可能嵌套在Flyway的迁移事务中，导致变更未即时生效。

对应解决办法 #

1. 强制刷新EntityManager缓存 #

在Java迁移脚本执行完数据操作后，手动触发缓存刷新与清空，确保变更写入数据库：

@Component
public class Vx_y_z__YourMigration implements SpringJdbcMigration {
    @Autowired
    private EntityManager entityManager;
    @Autowired
    private YourRepository repository;

    @Override
    public void migrate(JdbcTemplate jdbcTemplate) throws Exception {
        // 执行数据变更操作
        repository.saveAll(yourDataList);
        // 刷新到数据库并清空缓存
        entityManager.flush();
        entityManager.clear();
    }
}

2. 调整事务传播行为 #

避免Java迁移脚本的事务嵌套到Flyway的全局事务中，使用REQUIRES_NEW传播行为强制开启独立事务：

@Component
public class Vx_y_z__YourMigration implements SpringJdbcMigration {
    @Autowired
    private YourService migrationService;

    @Override
    public void migrate(JdbcTemplate jdbcTemplate) throws Exception {
        migrationService.performMigration();
    }
}

// 服务层方法
@Service
public class YourService {
    @Autowired
    private YourRepository repository;

    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void performMigration() {
        // 迁移逻辑
        repository.updateSomeData();
    }
}

3. 校验事务提交状态 #

• 查看flyway_schema_history表，确认前序脚本的状态为SUCCESS，且对应的数据库变更已实际存在。
• 若使用SQL脚本，确保脚本内未包含未提交的事务逻辑（Flyway默认每个脚本会自动提交事务，但自定义事务可能干扰）。

排查步骤 #

• 卡住时直接连接数据库，查询前序脚本对应的表结构或数据，确认变更是否已生效。
• 开启Flyway的DEBUG日志，查看迁移过程中的事务提交、SQL执行细节，定位未生效的环节。
• 单独执行第n-3个脚本，验证是否能独立识别前序变更，排除脚本自身逻辑问题。

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