Spring Boot中Liquibase约束违反时未记录错误问题求助

针对你遇到的问题——在SQL Server中添加JSON有效性CHECK约束后，Liquibase执行时违反约束却不记录错误，我结合实际项目经验给你几个可行的解决思路：

1. 提升Liquibase日志级别，捕获底层数据库错误 #

很多时候不是Liquibase没捕获到错误，而是默认日志级别太低，错误信息没打印出来。你可以在Spring Boot的配置文件里调整日志级别：

# application.properties
logging.level.liquibase=DEBUG

或者在Liquibase的changelog配置里开启详细日志输出。这样当约束违反时，Liquibase会打印出SQL Server返回的具体错误信息，包括约束名称和违反原因，方便你定位问题。

2. 在Liquibase Changelog中添加前置校验（PreConditions） #

与其等数据库抛出约束错误，不如在执行插入/更新操作前，用SQL Server的ISJSON()函数提前校验JSON有效性，让Liquibase直接终止执行并记录错误。

举个例子，在你的changeSet里添加前置校验：

<changeSet id="insert_ui_config" author="your-name">
    <preConditions onFail="HALT" onError="HALT">
        <sqlCheck expectedResult="1">
            SELECT ISJSON('${ui_config_json}')
        </sqlCheck>
    </preConditions>
    <insert tableName="ui_config">
        <column name="config_data" value="${ui_config_json}"/>
    </insert>
</changeSet>

这里onFail="HALT"会让Liquibase在校验失败时直接停止执行，并在日志中明确记录“前置校验失败”的信息，比数据库约束报错更直观。

3. 确保SQL Server的CHECK约束正确生效 #

先确认你的约束确实在数据库中生效了，避免因为约束创建失败导致的无报错情况。手动执行以下SQL验证约束：

-- 检查约束是否存在
SELECT name FROM sys.check_constraints WHERE parent_object_id = OBJECT_ID('ui_config') AND name = 'chk_valid_json';

-- 测试插入无效JSON，看数据库是否抛出错误
INSERT INTO ui_config (config_data) VALUES ('invalid-json');

如果数据库本身能抛出CHECK constraint violated的错误，那问题肯定出在Liquibase的错误捕获或日志配置上；如果数据库没报错，那先修复约束的创建语句。

4. 自定义Liquibase错误监听 #

如果以上方法都不行，你可以通过Spring Boot自定义Liquibase的执行监听器，捕获ChangeSet执行时的异常并手动记录日志：

@Component
public class LiquibaseErrorListener extends AbstractLiquibaseListener {

    private static final Logger logger = LoggerFactory.getLogger(LiquibaseErrorListener.class);

    @Override
    public void onChangeSetFailed(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Exception exception, Database database) {
        logger.error("ChangeSet {} 执行失败，原因：{}", changeSet.getId(), exception.getMessage(), exception);
        // 可以在这里添加额外的告警逻辑，比如发送邮件通知
    }
}

这个监听器会在任何changeSet执行失败时触发，包括约束违反的情况，确保错误信息被完整记录。

我之前在维护Spring Boot+Liquibase+SQL Server的项目时，就是通过调整日志级别+前置校验的组合解决了类似问题，既保证了数据的有效性，又能清晰看到错误原因。

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