已有数据库的Spring Boot项目如何通过JPA Buddy启用Liquibase

一、正确注册当前数据库基线（解决执行Init Changelog报错问题） #

不要直接使用JPA Buddy生成的Init Changelog（它会生成所有表的创建语句，现有数据库执行必然冲突），正确步骤如下：

• 用JPA Buddy生成空白初始变更日志，命名为db.changelog-1.0.xml（或yaml/sql格式，路径放在src/main/resources/db/changelog/下）。
• 执行Liquibase的changelog-sync命令，将这条空白日志标记为已执行：
  Maven项目：

  ./mvnw liquibase:changelogSync -Dliquibase.changeLogFile=src/main/resources/db/changelog/db.changelog-1.0.xml
  

  Gradle项目：

  ./gradlew liquibaseChangelogSync -PliquibaseChangeLogFile=src/main/resources/db/changelog/db.changelog-1.0.xml
  

  这个操作只会在Liquibase的databasechangelog表中插入基线日志记录，不会修改现有数据库，相当于告诉Liquibase「当前数据库状态就是这个基线版本」。

二、后续表结构维护流程 #

• 每次修改实体类或数据库结构时，用JPA Buddy生成Diff Changelog（对比实体模型与当前数据库的差异），或手动编写变更语句，保存为新的变更日志文件（比如db.changelog-1.1.xml）。
• 配置Spring Boot自动执行变更日志（确保spring.liquibase.enabled=true，并指定spring.liquibase.change-log路径），启动应用时Liquibase会自动执行所有未标记的新变更。

三、新环境部署的数据库初始化 #

新环境部署时，Liquibase会从基线日志开始，依次执行所有变更文件，自动创建完整的数据库表结构，无需额外操作。

四、如果已生成含创建表语句的Init Changelog的补救方案 #

修改该Init Changelog，给所有创建表的变更集添加preConditions判断，表不存在时才执行：

<changeSet id="init" author="your-name">
    <preConditions onFail="MARK_RAN">
        <not>
            <tableExists tableName="your_table"/>
        </not>
    </preConditions>
    <createTable tableName="your_table">
        <!-- 表结构定义 -->
    </createTable>
</changeSet>

之后执行changelog-sync标记该变更集为已执行，现有环境启动时会跳过执行，新环境则会正常创建表。

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