如何配置Liquibase实现Spring Boot仅在列不存在时添加新列？

开发者阿泽

2026-8-12

问题描述

在Spring Boot启动时使用Liquibase为现有数据表添加新列，但此前已手动在当前schema中添加过该列，启动时触发列已存在的报错：

Error creating bean with name 'liquibase' defined in class path resource
[...LiquibaseConfiguration.class]: LiquibaseException:
liquibase.exception.MigrationFailedException: Migration failed for
change set db/changelog/AlterTable_MyTable_AddNewCol.xml::1::me (manual):
Reason: liquibase.exception.DatabaseException:
Duplicate column name 'new_col' [Failed SQL: (1060)
ALTER TABLE my_schema.my_table ADD new_col INT NULL]

需要实现仅当列不存在时添加新列，列已存在时不报错的效果，尝试了以下配置但仍报错：

<databaseChangeLog ... >
    <changeSet author="me (manual)" id="1">
        <preConditions onFail="WARN">
            <columnExists tableName="my_table" columnName="new_col" />
        </preConditions>
        <addColumn tableName="my_table">
            <column name="new_col" type="integer"/>
        </addColumn>
    </changeSet>
</databaseChangeLog>

解决方案

你当前的前置条件逻辑完全搞反了：<columnExists>是检查列存在时才执行后续操作，这和你想要的“列不存在才添加”需求相悖。

正确配置需用<not>标签包裹<columnExists>，实现列不存在时才执行添加操作，同时配合onFail="MARK_RAN"让Liquibase标记该变更集已执行，避免重复校验报错：

<databaseChangeLog ... >
    <changeSet author="me (manual)" id="1">
        <preConditions onFail="MARK_RAN">
            <not>
                <columnExists tableName="my_table" columnName="new_col" schemaName="my_schema"/>
            </not>
        </preConditions>
        <addColumn tableName="my_table" schemaName="my_schema">
            <column name="new_col" type="integer" nullable="true"/>
        </addColumn>
    </changeSet>
</databaseChangeLog>

核心要点：

<not>反转了<columnExists>的检查逻辑，仅当目标列不存在时，才会执行<addColumn>操作
onFail="MARK_RAN"：若前置条件不满足（列已存在），Liquibase会将该变更集标记为“已执行”，既不会报错，也不会重复执行
显式指定schemaName，避免多schema环境下的表识别歧义
把nullable="true"明确写出，和手动添加列的NULL属性保持一致，提升配置可读性

配置完成后，Spring Boot启动时若列已存在，Liquibase会自动跳过该变更集，不会抛出重复列的错误。

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

如何配置Liquibase实现Spring Boot仅在列不存在时添加新列？

核心要点： #

核心要点：