SpringBoot中javax.persistence相关包无法找到的问题求助

问题背景 #

刚入门SpringBoot，编写实体类时提示找不到javax.persistence相关包，已添加spring-boot-starter-data-jpa依赖，执行过Maven重载、重建项目操作，问题仍未解决。

实体类代码 #

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class ExampleEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
}

pom.xml 配置片段 #

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>

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

    <!-- H2 Database -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

排查与解决步骤 #

1. 确认Spring Boot版本兼容性 #

如果使用的是Spring Boot 3.x，JPA API已从javax.persistence迁移到jakarta.persistence，这是最常见的原因。直接修改实体类的导入语句：

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

2. 验证Maven依赖状态 #

• 打开IDE的Maven面板，检查spring-boot-starter-data-jpa依赖是否正常加载（无红色警告标识）。
• 若依赖异常，删除本地Maven仓库中该依赖的文件夹，执行mvn clean install -U命令重新拉取依赖。

3. 清理IDE缓存 #

IDE缓存可能导致依赖无法识别，执行缓存清理：

• IDEA：点击File -> Invalidate Caches...，选择Invalidate and Restart
• Eclipse：点击Project -> Clean，然后右键项目选择Maven -> Update Project

4. 检查父依赖配置 #

确保pom.xml顶部包含Spring Boot父依赖，这是管理starter版本的核心：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>你的Spring Boot版本号</version>
    <relativePath/>
</parent>

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