升级liquibase-core至4.21.0后update方法无法生成databasechangeloglock表

云上老周

2026-7-24

Liquibase 4.21.0升级后缺失databasechangelog系列表的解决办法

问题背景

升级liquibase-core至4.21.0版本后，原无参update()方法被废弃，改用带Contexts和Writer参数的update()方法。但在全新环境运行时，旧方法自动创建的databasechangelog和databasechangeloglock表不再生成，导致运行报错，调试确认CreateDatabaseChangeLogLockTableGenerator的generateSql方法未被调用。

解决办法

手动触发系统表初始化：在调用带参update()前，显式调用数据库对象的表创建方法，确保系统表提前生成。示例代码：

// 假设已完成Database对象的初始化
database.createDatabaseChangeLogTable();
database.createDatabaseChangeLogLockTable();

// 执行带参update操作
liquibase.update(new Contexts(), new PrintWriter(System.out));

使用完整命令执行流程：旧无参update()内部通过UpdateCommandStep等组件完成包含系统表初始化的完整变更流程，可手动构建该流程替代直接调用update(Contexts, Writer)。示例逻辑：

UpdateCommandStep updateCommand = new UpdateCommandStep();
CommandScope commandScope = new CommandScope(UpdateCommandStep.COMMAND_NAME)
        .addArgumentValue(DatabaseCommandStep.DATABASE_ARG, database)
        .addArgumentValue(ChangeLogCommandStep.CHANGELOG_FILE_ARG, changelogFilePath)
        .addArgumentValue(ContextsCommandStep.CONTEXTS_ARG, new Contexts())
        .addArgumentValue(OutputWriterCommandStep.OUTPUT_WRITER_ARG, new PrintWriter(System.out));
commandScope.execute();