Spring Boot测试中H2数据库Liquibase迁移未执行问题

以下是针对该问题的排查和解决思路：

• 显式开启测试环境的Liquibase执行
  Spring Boot在部分测试场景下可能默认禁用Liquibase，需在测试配置文件（如src/test/resources/application-test.properties）中明确启用：

  spring.liquibase.enabled=true
  

  同时确认变更日志路径配置正确，比如：

  spring.liquibase.change-log=classpath:/db/changelog/db.changelog-master.xml
  

  若使用了环境profile，要保证测试用的profile加载了上述配置。

• 修正H2内存数据库URL配置
  H2内存库默认是会话隔离的，可能导致Liquibase初始化的数据库和测试代码连接的不是同一个实例。修改URL添加持久化参数：

  spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
  

  若迁移脚本依赖特定数据库语法，需指定H2的兼容模式，比如：

  spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE;MODE=MySQL
  

• 检查Liquibase上下文/标签匹配
  若变更日志中使用了<context>或标签过滤，测试环境可能未匹配到对应的上下文。在测试配置中指定要激活的上下文：

  spring.liquibase.contexts=test
  

  若使用了标签排除规则，确保测试环境不排除目标变更集：

  spring.liquibase.labels=!prod
  

• 开启Liquibase DEBUG日志排查
  启用详细日志可以看清Liquibase的执行细节，定位未执行迁移的原因：

  logging.level.liquibase=DEBUG
  

  从日志中可查看变更集是否被识别、是否因上下文不匹配/已标记为执行等原因被跳过。

• 手动触发迁移（备选方案）
  如果自动执行仍有问题，可在测试类中手动调用Liquibase的迁移逻辑：

  @SpringBootTest
  class YourApplicationTest {
  
      @Autowired
      private SpringLiquibase liquibase;
  
      @BeforeEach
      void runMigrations() throws LiquibaseException {
          liquibase.afterPropertiesSet();
      }
  
      // 测试方法...
  }
  

  这种方式能确保在测试方法执行前强制完成所有迁移。

内容的提问来源于stack exchange，提问作者Артём Власов