在GCP中运行Liquibase创建库表时遇ClassNotFoundException求助

我之前在使用Liquibase搭配Hibernate处理数据库Schema时碰到过几乎一模一样的错误，这个问题核心是Liquibase无法找到Hibernate JAXB相关的类，大概率是依赖配置或者版本兼容的问题，给你几个实用的排查方向：

1. 核对Liquibase与Hibernate依赖的版本兼容性 #

Liquibase的Hibernate集成模块（比如liquibase-hibernate5/liquibase-hibernate6）对Hibernate核心版本有严格要求，版本不匹配很容易导致类找不到的问题：

• 如果你用的是liquibase-hibernate5，要搭配Hibernate 5.x系列版本，不能混用Hibernate 6.x的包；反之liquibase-hibernate6要对应Hibernate 6.x。
• 建议直接查看Liquibase官方的依赖兼容文档，调整你的构建文件（Maven/Gradle），排除掉冲突的Hibernate依赖。比如Maven里可以用<exclusions>标签去掉不兼容的包。

2. 确认缺失的Hibernate JAXB依赖 #

org.hibernate.boot.jaxb.hbm.spi.package-info属于Hibernate的JAXB映射模块，可能你的依赖中缺少了必要的包：

• 确保已经引入了hibernate-core以及对应的Liquibase-Hibernate集成依赖，并且依赖范围是compile或者runtime（不要设为provided，除非你确认GCP环境已经自带了对应版本的包）。
• 举个Maven依赖配置的例子（对应Liquibase+Hibernate5）：

  <dependency>
      <groupId>org.liquibase.ext</groupId>
      <artifactId>liquibase-hibernate5</artifactId>
      <version>4.22.0</version> <!-- 替换为你使用的Liquibase兼容版本 -->
  </dependency>
  <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>5.6.15.Final</version> <!-- 与liquibase-hibernate5版本匹配 -->
  </dependency>
  

3. 排查GCP环境的类加载冲突 #

GCP的App Engine、Cloud SQL等环境可能自带一些基础类库，容易和你的应用依赖产生冲突：

• 尝试将所有依赖打包成Fat Jar（比如用Maven Shade插件或者Gradle Shadow插件），确保应用需要的所有类都包含在Jar包内，避免被环境的类加载器优先加载不兼容的版本。
• 检查Cloud Build的构建脚本，确认没有遗漏或错误排除必要的依赖。

4. 验证Liquibase配置中的Hibernate映射 #

如果你的Liquibase changelog中使用了Hibernate相关的映射配置（比如<hibernate:mapping>标签）：

• 确认映射文件的路径在类路径下是可访问的，没有拼写错误或者路径错误。
• 检查引用的实体类是否存在，并且类路径配置正确，错误的映射配置也可能触发类加载失败的异常。

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