在无依赖管理工具的Java Web应用中集成Spring Boot，同时兼容Hibernate 3与Hibernate 5遇NoClassDefFoundError问题求助

嗨，这个兼容问题确实挺棘手的——既要保留依赖Hibernate 3的老代码，又要在同一个Web应用里跑用Hibernate 5的Spring Boot，还没法用Maven/Gradle这类依赖管理工具来做隔离。我来给你梳理几个可行的解决方案：

核心问题分析 #

你遇到的NoClassDefFoundError: org/hibernate/jdbc/JDBCContext，本质是类加载冲突：Hibernate 3里存在这个类，但Hibernate 5已经移除了它，老代码试图加载这个类时，却被Spring Boot引入的Hibernate 5 jar包干扰，导致找不到正确的类。解决的关键是把两个版本的Hibernate隔离开，让老代码和Spring Boot各自用自己的Hibernate类。

可行解决方案 #

1. 利用Web容器的类加载层次做隔离 #

这是最容易实现的方案，不用改代码，只调整jar包的存放位置：

• 把老项目依赖的所有Hibernate 3相关jar包放到Web容器的全局lib目录（比如Tomcat的CATALINA_HOME/lib），由容器的顶级类加载器加载。这样老代码在加载Hibernate类时，会优先找到容器级的Hibernate 3类。
• 把Spring Boot和它依赖的所有Hibernate 5相关jar包放到项目的WEB-INF/lib目录，由Web应用的类加载器加载。Spring Boot的代码会优先加载自己目录下的Hibernate 5类，不会和容器级的Hibernate 3冲突。
• 注意：要确保老代码不会意外引用Hibernate 5的类，反之亦然——因为容器级的类对Web应用类加载器是可见的，所以别让老代码的逻辑去调用Spring Boot的Hibernate相关代码，避免混淆。

2. 给Spring Boot模块自定义类加载器 #

如果容器级隔离满足不了需求（比如容器里还有其他应用也用Hibernate），可以给Spring Boot的代码单独指定类加载器：

• 把Spring Boot所有依赖（包括Hibernate 5）打包成一个独立的JAR包（比如spring-boot-bundle.jar）。
• 在初始化Spring Boot上下文的时候，用自定义的URLClassLoader加载这个JAR，并且把父类加载器设置为容器类加载器的父级，避免加载到老项目的Hibernate 3类：

  // 初始化Spring Boot上下文时指定自定义类加载器
  AnnotationConfigApplicationContext springBootContext = new AnnotationConfigApplicationContext();
  URL[] bootJarUrls = new URL[]{new File("WEB-INF/lib/spring-boot-bundle.jar").toURI().toURL()};
  // 父类加载器跳过Web应用的类加载器，直接用容器的父加载器，避免加载老项目的Hibernate3类
  ClassLoader bootClassLoader = new URLClassLoader(bootJarUrls, Thread.currentThread().getContextClassLoader().getParent());
  springBootContext.setClassLoader(bootClassLoader);
  springBootContext.register(YourSpringBootConfig.class);
  springBootContext.refresh();
  

• 这种方式能做到严格的类隔离，但要注意处理类加载器之间的资源访问问题，比如数据库连接池的共享。

3. 分别配置独立的Hibernate会话工厂 #

确保老代码和Spring Boot各自用自己的Hibernate会话工厂，明确指定配置文件和类路径：

• 老代码的Hibernate 3配置：单独写一个hibernate3.cfg.xml，用Hibernate 3的API初始化会话工厂，完全和Spring Boot的配置隔离：

  // 老代码专属的Hibernate3会话工厂
  Configuration h3Config = new Configuration();
  h3Config.configure("/hibernate3.cfg.xml");
  SessionFactory h3SessionFactory = h3Config.buildSessionFactory();
  

• Spring Boot的Hibernate 5配置：用Spring提供的LocalSessionFactoryBean，指定自己的实体包和Hibernate属性，确保用的是Hibernate 5的实现：

  @Bean
  public LocalSessionFactoryBean springBootSessionFactory() {
      LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
      sessionFactory.setDataSource(springBootDataSource()); // 单独的数据源（可选）
      sessionFactory.setPackagesToScan("com.your.springboot.entity");
      sessionFactory.setHibernateProperties(hibernate5Properties());
      return sessionFactory;
  }
  
  private Properties hibernate5Properties() {
      Properties props = new Properties();
      props.put("hibernate.dialect", "org.hibernate.dialect.MySQL5Dialect");
      // 其他Hibernate5专属配置
      return props;
  }
  

额外注意事项 #

• 你的Spring Boot版本是1.5.22.RELEASE，它默认适配的Hibernate版本是5.0.x系列，不要随意升级Hibernate 5到更高版本，避免和Spring 4.3.25.RELEASE出现兼容性问题。
• 所有调整后一定要分别测试老代码和Spring Boot模块的数据库操作，确保两者都能正常运行，没有类加载异常。

备注：内容来源于stack exchange，提问作者Mohamad Jaafar