使用Hibernate开发应用时遭遇java.lang.NoSuchMethodError错误求助

这个错误的根源很明确：你的项目使用的JPA API版本低于2.1，而Table.indexes()方法是JPA 2.1才新增的接口方法。Hibernate（尤其是5.x及以上版本）依赖JPA 2.1+的API，当旧版本的JPA API被优先加载时，就会出现这个找不到方法的错误。

下面是具体的解决步骤：

1. 替换旧的JPA API依赖 #

检查你的pom.xml，如果存在类似下面的旧JPA依赖（这是JPA 2.0及更早版本的依赖）：

<dependency>
    <groupId>javax.persistence</groupId>
    <artifactId>persistence-api</artifactId>
    <version>1.0.2</version>
</dependency>

请立即替换为JPA 2.1+的官方API依赖：

<dependency>
    <groupId>javax.persistence</groupId>
    <artifactId>javax.persistence-api</artifactId>
    <version>2.2</version> <!-- 推荐使用2.2版本，完美兼容Hibernate 5.x -->
</dependency>

2. 确保Hibernate与JPA版本匹配 #

不同版本的Hibernate对应不同的JPA规范版本，别搞混了：

• Hibernate 5.x → JPA 2.1/2.2
• Hibernate 6.x → JPA 3.0+（注意这里包名从javax.persistence改为jakarta.persistence）

如果你的项目用的是Hibernate 5.x，其实可以直接依赖Hibernate核心包，它会自动引入匹配的JPA API，从根源避免版本冲突：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.6.15.Final</version> <!-- 选一个稳定的5.x版本即可 -->
</dependency>

3. 排查并排除冲突的依赖 #

有时候第三方依赖会偷偷引入旧版本的JPA API，导致版本冲突。你可以用Maven的依赖树命令揪出这些冲突：

mvn dependency:tree

如果发现某个依赖引入了javax.persistence:persistence-api，就在该依赖里添加排除规则：

<dependency>
    <groupId>第三方依赖的groupId</groupId>
    <artifactId>第三方依赖的artifactId</artifactId>
    <version>对应版本</version>
    <exclusions>
        <exclusion>
            <groupId>javax.persistence</groupId>
            <artifactId>persistence-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

完成以上步骤后，执行mvn clean install重新构建项目，这个错误应该就能彻底解决了。

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