基于RPM部署的现有产品引入Liquibase数据库迁移方案咨询

我来分享几个适配你场景的实用方案，既能让初始Schema仅在全新环境执行，又能给已有系统的初始状态打上Liquibase执行标记，完全不需要依赖容易出错的外部上下文参数：

1. 用preConditions控制初始Schema的执行时机 #

把你生成的初始Schema变更日志（比如initial-schema.xml）单独拆分出来，然后在这个文件的根节点添加预检查条件，只有当数据库是全新状态时才执行它：

<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.19.xsd">

    <!-- 预检查：如果Liquibase元数据表不存在，才执行初始Schema -->
    <preConditions onFail="MARK_RAN">
        <not>
            <tableExists tableName="DATABASECHANGELOG"/>
        </not>
    </preConditions>

    <!-- 这里放你用generateChangeLog生成的初始Schema变更集 -->
    ...

</databaseChangeLog>

• onFail="MARK_RAN"：如果预检查不通过（也就是已有Liquibase元数据表），会把这个变更日志标记为已执行，但不会实际运行里面的SQL。
• 你也可以换成检查产品的核心业务表是否存在，比如<tableExists tableName="your_core_business_table"/>，更贴合业务场景。

然后在你的master.xml里按顺序引入这个初始文件和后续变更：

<include file="initial-schema.xml"/>
<include file="v1.1-user-module-upgrade.xml"/>
<include file="v1.2-order-fix.xml"/>

2. 给已有环境同步初始变更标记 #

对于已经存在的集成/生产环境，你不需要重复运行初始Schema的SQL，但需要把它标记为已执行，让Liquibase认可这个初始状态是它管理的。可以用Liquibase的changelogSync命令：

liquibase changelogSync --changelog-file=initial-schema.xml

这个命令会把initial-schema.xml里的所有变更集都写入DATABASECHANGELOG表，标记为已执行，但不会执行任何实际的数据库操作。

3. RPM部署脚本的整合逻辑 #

把上面的逻辑整合到RPM的postinstall部署脚本里，让整个流程自动化：

#!/bin/bash

# 从RPM配置文件加载Liquibase参数
source /etc/your-product/liquibase.conf
LIQUIBASE_CHANGELOG="/opt/your-product/liquibase/master.xml"
INITIAL_CHANGELOG="/opt/your-product/liquibase/initial-schema.xml"

# 检查DATABASECHANGELOG表是否存在（以MySQL为例，其他数据库需调整语句）
TABLE_EXISTS=$(mysql -h $DB_HOST -u $DB_USER -p$DB_PASS -e "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = '$DB_NAME' AND table_name = 'DATABASECHANGELOG';" | tail -n 1)

if [ "$TABLE_EXISTS" -eq 0 ]; then
    # 全新环境：直接执行update，自动创建元数据表并运行初始Schema
    liquibase --url=$LIQUIBASE_URL --username=$DB_USER --password=$DB_PASS update
else
    # 已有环境：先同步初始变更标记，再执行后续更新
    liquibase --url=$LIQUIBASE_URL --username=$DB_USER --password=$DB_PASS changelogSync --changelog-file=$INITIAL_CHANGELOG
    liquibase --url=$LIQUIBASE_URL --username=$DB_USER --password=$DB_PASS update
fi

• 注意：不同数据库的表存在性检查语句需要调整，比如PostgreSQL用SELECT EXISTS(SELECT 1 FROM information_schema.tables WHERE table_name = 'DATABASECHANGELOG');
• 建议把数据库配置放到单独的配置文件中，避免硬编码在脚本里，提升灵活性。

额外技巧 #

• 给初始变更集加runAlways="false"：双重保险，确保即使预检查失效，也不会重复执行初始Schema的SQL。
• 测试两种场景：在测试环境分别模拟全新数据库和已有数据库，验证部署脚本的行为是否符合预期。
• 版本控制变更日志：所有Liquibase变更文件都要纳入代码版本控制，确保RPM包中的变更日志和代码仓库完全一致。

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