如何用Liquibase跟踪数据库变更并处理已存在约束冲突

针对你遇到的已有唯一约束导致changelog执行报错的问题，以下是几种可行的解决方案，无需删除数据库即可实现类似createTable的ifNotExists效果：

方法1：通过预检查（preConditions）判断约束是否存在 #

这是跨数据库通用的方案，通过查询系统表确认约束不存在后，再执行添加操作：

<changeSet id="add-uq-user-email" author="your-username">
    <preConditions onFail="MARK_RAN">
        <not>
            <sqlCheck expectedResult="1">
                <!-- 以下是MySQL的查询示例，其他数据库需调整系统表语法 -->
                SELECT 1 FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS 
                WHERE CONSTRAINT_TYPE = 'UNIQUE' 
                AND TABLE_SCHEMA = DATABASE() 
                AND TABLE_NAME = 'user' 
                AND CONSTRAINT_NAME = 'uq_user_email'
            </sqlCheck>
        </not>
    </preConditions>
    <addUniqueConstraint 
        tableName="user" 
        columnNames="email" 
        constraintName="uq_user_email"/>
</changeSet>

• 关键说明：
  • onFail="MARK_RAN"：如果约束已存在，直接标记该变更集为已执行，不会抛出错误。
  • 系统表查询需适配你的数据库：比如PostgreSQL用information_schema.table_constraints但筛选条件需调整，Oracle用USER_CONSTRAINTS。

方法2：利用数据库原生的条件创建语法 #

部分数据库版本支持直接在SQL中添加IF NOT EXISTS，可以通过Liquibase的modifySql修改生成的语句，或者直接写原生SQL：

MySQL 8.0.19+ 示例 #

<changeSet id="add-uq-user-phone" author="your-username">
    <addUniqueConstraint 
        tableName="user" 
        columnNames="phone" 
        constraintName="uq_user_phone"/>
    <modifySql>
        <replace replace="ADD CONSTRAINT" with="ADD CONSTRAINT IF NOT EXISTS"/>
    </modifySql>
</changeSet>

PostgreSQL 示例 #

<changeSet id="add-uq-user-phone" author="your-username">
    <sql>
        CREATE UNIQUE INDEX IF NOT EXISTS uq_user_phone ON user (phone);
    </sql>
</changeSet>

这种方法更简洁，但依赖数据库的版本特性，通用性不如预检查方案。

方法3：使用Liquibase内置的约束存在检查 #

如果你的Liquibase版本支持（通常3.5+），可以用内置的constraintExists预检查简化代码：

<changeSet id="add-uq-user-username" author="your-username">
    <preConditions onFail="MARK_RAN">
        <not>
            <constraintExists tableName="user" constraintName="uq_user_username"/>
        </not>
    </preConditions>
    <addUniqueConstraint 
        tableName="user" 
        columnNames="username" 
        constraintName="uq_user_username"/>
</changeSet>

重要提醒 #

• 必须明确指定constraintName：如果不手动指定，Liquibase会自动生成随机约束名，导致后续的存在检查失效。
• 若已有变更集执行报错，可以用liquibase markNextChangeSetRan命令标记该变更集为已执行，避免重复触发错误。

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