解决Java17环境下Liquibase无法解析YAML变更日志的异常

问题核心原因 #

XML格式变更日志可正常运行，但YAML格式触发UnknownChangelogFormatException，本质是Java17的模块化机制或类加载规则变化，导致Liquibase无法自动加载YAML解析器组件（XML解析为Liquibase核心内置功能，无需额外依赖）。

修复步骤 #

1. 确保包含YAML解析依赖包 #

Liquibase的YAML解析功能依赖单独的liquibase-yaml.jar模块，需将其加入命令的classpath中：

• 确认环境变量LIQUIBASE_YAML_JAR指向该jar包的路径
• 修改执行脚本的--classpath参数，添加该依赖：

  --classpath=${DRIVER_JAR}:${LIQUIBASE_SESSION_LOCK_JAR}:${LIQUIBASE_YAML_JAR}
  

2. 调整包扫描配置 #

Java17下需明确指定Liquibase扫描的包范围，确保包含YAML解析器所在包：

• 更新LIQUIBASE_PACKAGES_SCAN变量，添加YAML解析相关包：

  export LIQUIBASE_PACKAGES_SCAN="liquibase.parser,liquibase.changelog,liquibase.ext"
  

  其中liquibase.parser.core.yaml是YAML解析器的核心包，包含在liquibase.parser扫描范围内。

3. 修复后的完整执行脚本示例 #

# args:
#   change_log_file [required]
#   extra args (eg. JVM args) [optional]
function liquibase {
    java \
        -Dliquibase.scan.packages=${LIQUIBASE_PACKAGES_SCAN:-liquibase.parser,liquibase.changelog,liquibase.ext} \
        $2 \
        -jar ${LIQUIBASE_JAR} \
        --url=${URL} \
        --username=${USERNAME} \
        --password=${PASSWORD} \
        --driver=${DRIVER} \
        --classpath=${DRIVER_JAR}:${LIQUIBASE_SESSION_LOCK_JAR}:${LIQUIBASE_YAML_JAR} \
        --changeLogFile=$1 \
        --logLevel=${LOG_LEVEL:-DEBUG} \
        update
    return $?
}

4. 验证调试 #

若问题仍存在，添加--logLevel=DEBUG参数运行，查看日志中是否有YAML解析器类加载失败的信息，进一步排查依赖或路径问题。

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