PAYATHON 2026

Liquibase 的 onFail: CONTINUE 为何未跳过约束删除?

数据小陈

将 preConditions 放到需要跳过的 changeSet 内,并在其中配置 onFail: CONTINUE。你贴出的前置条件位于 databaseChangeLog 层级,无法用来按条件跳过单个 changeset。

为什么会出现 ValidationFailedException?

Liquibase 区分 changelog 级和 changeset 级前置条件。changelog 级前置条件在 changeset 执行前检查,在该层级配置 onFail: CONTINUE,无法实现“跳过当前 changeset 并继续”。应将该值放在 changeset 的前置条件中。Liquibase 前置条件文档

日志显示失败的是 uniqueConstraintExists 检查,不能据此认定 Liquibase 已执行了 dropUniqueConstraint。

你贴出的 YAML 没有显示必要的嵌套缩进。实际文件中,onFail 和 uniqueConstraintExists 都必须属于 preConditions,约束参数也必须属于对应的检查或变更。

如何修改 YAML?

在支持 uniqueConstraintExists 的 Liquibase 版本和支持该删除操作的数据库中,可以这样配置:

databaseChangeLog:
  - objectQuotingStrategy: QUOTE_ONLY_RESERVED_WORDS
  - changeSet:
      id: 000.2605121336__DropUniqueConstraintFromPersonName
      author: db_admin
      preConditions:
        - onFail: CONTINUE
        - uniqueConstraintExists:
            constraintName: person_name_key
            schemaName: ${schema}
            tableName: person
      changes:
        - dropUniqueConstraint:
            constraintName: person_name_key
            schemaName: ${schema}
            tableName: person
            uniqueColumns: name

示例通过约束名称检查是否存在,因此移除了检查中的 uniqueColumns: name。如果按列检查,uniqueConstraintExists 的参数名是 columnNames,不能直接套用 dropUniqueConstraint 的参数。uniqueConstraintExists 参数说明

删除操作中仍保留了 uniqueColumns: name。该参数有数据库适用范围,官方将其用于 SAP SQL Anywhere 的 UNIQUE 列列表,应根据实际数据库确认是否需要保留。dropUniqueConstraint 参数说明

CONTINUE 和 MARK_RAN 应该选哪个?

对于 changeset 级前置条件:

  • CONTINUE:条件失败时跳过该 changeset,继续处理后续变更;下次更新时仍会重新尝试。
  • MARK_RAN:条件失败时跳过实际操作,并将该 changeset 标记为已执行;后续通常不会再次尝试。

如果约束不存在时只想暂时跳过,使用 CONTINUE。如果这次迁移的目标是确保约束不存在,且确认以后无需重试,可以考虑 MARK_RAN。WARN 会继续执行变更,不能用于保护这次删除操作。onFail 行为说明

修改后仍有问题时检查什么?

确认 ${schema} 已解析为目标 schema,检查和删除使用的表名、约束名及 schema 也一致。如果数据库中确实存在该约束,再核对连接目标、名称大小写,以及当前用户读取元数据的权限。

onFail 处理检查结果不满足条件的情况;检查过程本身抛出异常则属于 onError。应先确认异常原因,不要仅为绕过异常就设置 onError: CONTINUE。原始材料没有提供 Liquibase 版本和数据库类型,无法判断是否还存在兼容性问题。

备注:内容仅供参考。