升级Liquibase至4.24.0/4.26.0触发InvocationTargetException报错求助

针对你升级Liquibase到4.24.0/4.26.0后出现的InvocationTargetException及后续StackOverflowError问题，以下是排查和解决方向：

核心问题分析 #

从堆栈跟踪看，异常触发路径是：
DatabaseFactory初始化 → 服务定位器扫描类 → 获取GlobalConfiguration的outputEncoding → Scope.getSingleton()调用构造器抛出异常
这大概率是依赖冲突、配置加载循环依赖或类扫描逻辑不兼容导致的。

具体解决步骤 #

1. 彻底清理依赖冲突 #

确保项目中仅存在目标版本的Liquibase依赖，排除所有旧版本或第三方引入的Liquibase相关jar：

• Maven项目：使用mvn dependency:tree命令检查依赖树，找出重复或旧版本的Liquibase依赖，在对应依赖中添加排除规则：

  <dependency>
      <groupId>你的依赖groupId</groupId>
      <artifactId>你的依赖artifactId</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.liquibase</groupId>
              <artifactId>liquibase-core</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• Gradle项目：使用./gradlew dependencies检查，通过exclude排除冲突依赖。

2. 提前初始化编码配置 #

在调用DatabaseFactory.getInstance()前，手动设置编码配置，避免类扫描时动态加载配置触发循环：

import liquibase.configuration.GlobalConfiguration;
import liquibase.configuration.LiquibaseConfiguration;

// 提前设置编码，避免初始化时的循环依赖
LiquibaseConfiguration.getInstance().setDefaultValue(GlobalConfiguration.OUTPUT_ENCODING, "UTF-8");

// 再初始化DatabaseFactory
DatabaseFactory dbFactory = DatabaseFactory.getInstance();

3. 适配服务定位器逻辑 #

如果你项目中自定义了PackageScanClassResolver或ServiceLocator实现，新版本Liquibase的服务定位逻辑有变更，需：

• 改用Liquibase默认的DefaultPackageScanClassResolver和ClasspathScanningServiceLocator
• 若必须自定义，确保实现类兼容4.24.0+的API（比如方法签名、初始化顺序）

4. 检查JDK兼容性与权限 #

• Liquibase 4.24.0+要求JDK 8及以上，若使用JDK 11/17等版本，需确保：
  • 项目模块配置（module-info.java）中允许Liquibase访问必要的反射权限
  • 没有添加限制反射的JVM参数（如--illegal-access=deny）

5. 手动注册数据库驱动（绕过类扫描） #

如果类扫描是异常根源，可以跳过自动扫描，手动注册所需的数据库实现：

import liquibase.database.DatabaseFactory;
import liquibase.database.core.MySQLDatabase;
import liquibase.database.core.OracleDatabase;

DatabaseFactory dbFactory = new DatabaseFactory();
dbFactory.registerDatabase(new MySQLDatabase());
dbFactory.registerDatabase(new OracleDatabase());
// 注册你需要的其他数据库

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