SpringBoot JPA报错疑缺依赖包：实现JPA时遇UnsatisfiedDependencyException

嘿，这个问题我帮不少开发者排查过，核心原因基本都是JPA相关依赖没配对，或者版本冲突——毕竟NoSuchMethodError大多是找不到对应的方法实现，要么缺依赖，要么依赖版本和SpringBoot不兼容。下面是具体的解决步骤：

1. 先确认有没有用SpringBoot官方的JPA Starter #

别自己手动引hibernate-core或者javax.persistence-api这类单独依赖，SpringBoot的starter已经帮你把所有适配好的依赖打包好了，直接用它就行：

Maven项目（pom.xml）： #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

Gradle项目（build.gradle）： #

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

划重点：手动加单独的JPA依赖很容易搞出版本冲突，starter是最稳妥的选择。

2. 排查有没有依赖冲突 #

如果已经加了starter还是报错，那大概率是其他依赖偷偷带了不兼容的JPA版本。你可以用命令导出依赖树看看：

Maven： #

mvn dependency:tree

Gradle： #

gradle dependencies

在输出里搜javax.persistence，要是看到多个版本的依赖，就把冲突的那个给排除掉。比如Maven里这么写：

<dependency>
    <!-- 这里是那个带冲突依赖的包 -->
    <groupId>com.example.conflict</groupId>
    <artifactId>conflict-dependency</artifactId>
    <exclusions>
        <exclusion>
            <groupId>javax.persistence</groupId>
            <artifactId>javax.persistence-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 注意SpringBoot版本的兼容性 #

要是你用的是SpringBoot 3.x版本，那它已经完全切换到Jakarta EE了，原来的javax.persistence已经改成jakarta.persistence了。这时候要是你的代码里还在用javax.persistence的注解，要么把代码里的包名换成jakarta.persistence，要么降级到SpringBoot 2.x版本（比如2.7.x）。

4. 清理缓存重新构建 #

有时候本地仓库的缓存会搞事情，你可以：

• 删除Maven缓存：删掉~/.m2/repository里和javax.persistence、org.hibernate相关的目录
• 删除Gradle缓存：删掉~/.gradle/caches目录
• 然后执行mvn clean install（Maven）或者gradle clean build（Gradle）重新构建

按上面的步骤走，基本就能解决这个报错了。

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