Spring Boot集成Liquibase：升级时跳过特定changeSet方案咨询

方案2的可行性 #

完全可行。liquibase changelog-sync的核心作用就是将指定changelog中的changeSet标记为已执行状态，不会实际运行SQL。你可以新增一个仅包含release3、4中那些已被整合到release1的重复changeSet的changelog文件，执行sync命令后，Liquibase的数据库changelog表（默认是databasechangelog）会记录这些changeSet的执行状态，后续升级时就会自动跳过它们，避免重复执行SQL。

需要注意：必须保证新增changelog里的changeSet的id、author、file（或路径）与原release3、4中的完全一致，否则sync无法匹配到对应记录，标记会失效。

Spring Boot中配置changelog-sync的方式 #

Spring Boot没有提供像spring.liquibase.change-log那样直接自动执行changelog-sync的配置项，但可以通过以下几种方式实现：

1. 自定义启动逻辑

   • 注入Liquibase实例（或SpringLiquibase），在应用启动时调用其changelogSync()方法，指定你新增的changelog文件路径。示例代码：

     @Component
     public class LiquibaseSyncRunner implements CommandLineRunner {
         private final Liquibase liquibase;
     
         public LiquibaseSyncRunner(Liquibase liquibase) {
             this.liquibase = liquibase;
         }
     
         @Override
         public void run(String... args) throws Exception {
             // 指定要同步的changelog文件路径
             liquibase.setChangeLog("classpath:liquibase/changelogs/skip-release3-4-changelog.xml");
             liquibase.changelogSync();
         }
     }
     

   • 可以通过@ConditionalOnProperty配置开关，控制这个逻辑只在需要的时候执行，避免每次启动都运行sync。

2. 构建阶段执行命令

   • 使用Maven或Gradle的Liquibase插件，在部署前执行changelog-sync命令。比如Maven插件配置：

     <plugin>
         <groupId>org.liquibase</groupId>
         <artifactId>liquibase-maven-plugin</artifactId>
         <version>你的Liquibase版本</version>
         <configuration>
             <changeLogFile>src/main/resources/liquibase/changelogs/skip-release3-4-changelog.xml</changeLogFile>
             <url>${spring.datasource.url}</url>
             <username>${spring.datasource.username}</username>
             <password>${spring.datasource.password}</password>
         </configuration>
         <executions>
             <execution>
                 <id>changelog-sync</id>
                 <phase>pre-integration-test</phase>
                 <goals>
                     <goal>changelogSync</goal>
                 </goals>
             </execution>
         </executions>
     </plugin>
     

3. 手动执行命令

   • 直接使用Liquibase CLI工具，结合Spring Boot的数据库配置执行sync：

     liquibase --changeLogFile=src/main/resources/liquibase/changelogs/skip-release3-4-changelog.xml \
               --url=jdbc:mysql://localhost:3306/your_db \
               --username=root \
               --password=your_pwd \
               changelog-sync
     

方案对比补充 #

• 方案1（preConditions）：更适合长期维护，能动态判断变更是否需要执行（比如检查表/列是否存在），不需要额外的sync操作，但需要逐个给changeSet添加preConditions，工作量可能较大。
• 方案2（changelog-sync）：适合一次性批量标记大量changeSet，操作高效，但依赖changeSet标识的完全匹配，后续如果changeSet有修改，需要同步更新这个新增的changelog文件，灵活性稍差。

内容的提问来源于stack exchange，提问作者Rachan R K