运行时出现java.lang.NoClassDefFoundError: org/hibernate/service/ServiceRegistry求助

问题描述 #

首次使用Hibernate框架，编译过程无异常，但运行生成的.jar文件时触发java.lang.NoClassDefFoundError: org/hibernate/service/ServiceRegistry错误。已添加hibernate-core和mysql-connector-j依赖，相关代码如下：

SessionFactory初始化代码 #

Configuration config = new Configuration();

DBDetails details = DBDetails.fromConfig(lib);

config.setProperty("hibernate.connection.driver_class", "com.mysql.jdbc.Driver");
config.setProperty("hibernate.connection.url",
        "jdbc:mysql://" + details.getHost() + ":" + details.getPort() + "/" + details.getDatabase());
config.setProperty("hibernate.connection.username", details.getUsername());
config.setProperty("hibernate.connection.password", details.getPassword());
config.setProperty("hibernate.dialect", "org.hibernate.dialect.MySQLDialect");
config.setProperty("hibernate.connection.pool_size", "1");

ServiceRegistry serviceRegistry = new StandardServiceRegistryBuilder()
        .applySettings(config.getProperties()).build();

this.sessionFactory = config.buildSessionFactory(serviceRegistry);

Vote实体类 #

@Entity
@Table(name = "votes")
@Data
@AllArgsConstructor
public class Vote {
    @Id
    @Column(name = "voter")
    private UUID voter;

    @Column(name = "voted")
    private UUID voted;
}

投票数据操作方法 #

public void addVote(Vote vote) {
        Session session = this.sessionFactory.getCurrentSession();
        session.beginTransaction();
        session.persist(vote);
        session.getTransaction().commit();
    }

    public Vote getVote(String voter) {
        Session session = this.sessionFactory.getCurrentSession();
        session.beginTransaction();
        Vote vote = session.get(Vote.class, voter);
        session.getTransaction().commit();
        return vote;
    }

错误原因与修复步骤 #

1. 打包时未包含运行时依赖 #

NoClassDefFoundError核心原因是运行时类路径缺失所需类，通常是因为仅添加了编译期依赖，未将所有依赖打包进最终的.jar文件。

修复方案：

• Maven项目：添加maven-assembly-plugin构建包含所有依赖的可执行jar
  在pom.xml中插入以下配置：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-assembly-plugin</artifactId>
              <version>3.6.0</version>
              <configuration>
                  <descriptorRefs>
                      <descriptorRef>jar-with-dependencies</descriptorRef>
                  </descriptorRefs>
                  <archive>
                      <manifest>
                          <mainClass>你的主类全限定名</mainClass>
                      </manifest>
                  </archive>
              </configuration>
              <executions>
                  <execution>
                      <id>make-assembly</id>
                      <phase>package</phase>
                      <goals>
                          <goal>single</goal>
                      </goals>
                  </execution>
              </executions>
          </plugin>
      </plugins>
  </build>
  

  执行mvn clean package后，使用带-jar-with-dependencies后缀的jar文件运行。

• Gradle项目：使用shadow插件构建fat jar
  在build.gradle中添加配置：

  plugins {
      id 'java'
      id 'com.github.johnrengelman.shadow' version '8.1.1'
  }
  
  shadowJar {
      mergeServiceFiles()
      manifest {
          attributes 'Main-Class': '你的主类全限定名'
      }
  }
  

  执行gradle shadowJar后，运行build/libs目录下的shadow jar文件。

2. 适配Hibernate版本与JDBC驱动 #

• 明确指定稳定的hibernate-core版本（避免版本兼容问题），例如Maven依赖：

  <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>5.6.15.Final</version>
  </dependency>
  

• 若使用mysql-connector-j 8.x版本，替换驱动类并更新JDBC URL：

  config.setProperty("hibernate.connection.driver_class", "com.mysql.cj.jdbc.Driver");
  config.setProperty("hibernate.connection.url",
          "jdbc:mysql://" + details.getHost() + ":" + details.getPort() + "/" + details.getDatabase() + "?serverTimezone=UTC");
  

修复后验证操作 #

• 重新打包并运行jar，确认NoClassDefFoundError错误消失
• 测试addVote方法：插入一条Vote数据，检查数据库是否生成对应记录
• 测试getVote方法：根据voter的UUID查询，确认能正确返回Vote对象
• 验证事务回滚：模拟重复插入同一voter的场景，确认事务能自动回滚
• 检查连接池：多次调用数据库操作，通过数据库连接数监控确认连接复用正常

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