WebSphere迁移Tomcat遇JPA版本冲突导致NoSuchMethodError问题

问题根源 #

javax.persistence.Table.indexes()是JPA 2.1及以上版本新增的方法，你的WebSphere遗留依赖中包含JPA 2.0版本的Table接口类，尽管已将JPA 2.2依赖置于类路径首位，但类加载器仍优先加载了旧版本的类，导致依赖JPA 2.2的Hibernate抛出NoSuchMethodError。

以下是基于类加载机制的几种更优解决方案：

方案1：Tomcat类加载器过滤旧JPA类 #

利用Tomcat的Web应用类加载器过滤特性，直接排除所有依赖中的旧JPA包，强制加载WEB-INF/lib中JPA 2.2的类。

在项目的META-INF/context.xml或Tomcat全局conf/context.xml中添加配置：

<Context>
  <!-- 配置Webapp类加载器，排除所有javax.persistence包的旧版本类 -->
  <Loader className="org.apache.catalina.loader.WebappClassLoader"
          filter="javax.persistence.*"/>
</Context>

该配置会让Tomcat忽略所有jar包中的javax.persistence路径下的类，仅加载你指定的JPA 2.2依赖中的对应类。注意：Tomcat 8及以上版本支持filter属性。

方案2：Maven依赖排除（可控移除旧JPA类） #

通过Maven的依赖排除规则，彻底移除WebSphere依赖中包含的JPA相关传递依赖，避免旧类被打包进应用。

在pom.xml中对WebSphere的依赖添加排除项：

<dependency>
  <groupId>com.ibm.websphere</groupId>
  <artifactId>your-websphere-dependency</artifactId>
  <version>x.x.x</version>
  <exclusions>
    <!-- 排除JPA 2.0相关依赖 -->
    <exclusion>
      <groupId>javax.persistence</groupId>
      <artifactId>persistence-api</artifactId>
    </exclusion>
    <exclusion>
      <groupId>org.eclipse.persistence</groupId>
      <artifactId>javax.persistence</artifactId>
    </exclusion>
    <!-- 根据实际情况添加其他包含JPA类的依赖排除 -->
  </exclusions>
</dependency>

同时显式引入JPA 2.2依赖，确保其优先级：

<dependency>
  <groupId>javax.persistence</groupId>
  <artifactId>javax.persistence-api</artifactId>
  <version>2.2</version>
  <scope>compile</scope>
</dependency>

方案3：自定义类加载器优先加载JPA 2.2 #

编写自定义类加载器，继承Tomcat的WebappClassLoader，重写类加载逻辑，确保javax.persistence相关类优先从JPA 2.2的jar中加载。

1. 编写自定义类加载器：

public class CustomJPAClassLoader extends WebappClassLoader {
    private static final String JPA_PACKAGE_PREFIX = "javax.persistence.";
    private File jpa22Jar;

    public CustomJPAClassLoader(ClassLoader parent) {
        super(parent);
        // 定位WEB-INF/lib中的JPA2.2 jar文件
        String libPath = getResource("/WEB-INF/lib/").getPath();
        jpa22Jar = new File(libPath + "javax.persistence-api-2.2.jar");
    }

    @Override
    protected Class<?> findClass(String name) throws ClassNotFoundException {
        if (name.startsWith(JPA_PACKAGE_PREFIX)) {
            try {
                // 优先从JPA2.2 jar加载类
                JarFile jarFile = new JarFile(jpa22Jar);
                JarEntry entry = jarFile.getJarEntry(name.replace('.', '/') + ".class");
                if (entry != null) {
                    InputStream is = jarFile.getInputStream(entry);
                    byte[] bytes = IOUtils.toByteArray(is);
                    return defineClass(name, bytes, 0, bytes.length);
                }
            } catch (IOException e) {
                throw new ClassNotFoundException("Failed to load JPA class: " + name, e);
            }
        }
        // 其他类按原有逻辑加载
        return super.findClass(name);
    }
}

2. 在项目的META-INF/context.xml中指定使用该类加载器：

<Context>
  <Loader className="com.yourcompany.CustomJPAClassLoader"/>
</Context>

方案优先级推荐 #

1. 方案2：通过Maven依赖排除从根源避免旧类被引入，最可控且无需额外容器配置。
2. 方案1：Tomcat内置配置，简单高效，适合无法修改依赖的场景。
3. 方案3：自定义类加载器灵活性高，但需要编写和维护代码，适合复杂类加载场景。

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