Spring Boot从JDK8迁移至JDK17时JPA实体未托管错误排查

这个错误的核心是JPA无法识别UserPreferences实体类，主要是Spring Boot 3.x升级带来的注解包变更或扫描范围问题，以下是具体解决步骤：

1. 显式指定实体类与Repository的扫描范围 #

Spring Boot 3.x的自动扫描逻辑在部分场景下可能无法覆盖深层子包，需手动声明扫描路径：
修改应用入口类，添加@EntityScan和@EnableJpaRepositories注解：

@ConfigurationPropertiesScan
@SpringBootApplication
@EntityScan(basePackages = "com.thetisit.felayer.entity") // 指定实体类所在包
@EnableJpaRepositories(basePackages = "com.thetisit.felayer.repository") // 指定Repository所在包
public class SecuredUsersFELayer {

    public static void main(String[] args) {
        SpringApplication.run(SecuredUsersFELayer.class, args);
    }
}

2. 替换JPA注解的导入包 #

Spring Boot 3.x基于Jakarta EE 9，所有JPA相关注解已从javax.persistence.*迁移到jakarta.persistence.*，必须修改实体类的导入：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Table;

@Entity
@Table(name = "USERS_PREFERENCES")
public class UserPreferences {

    @Id
    private String username;

    private String preferences;
    
    // getters and setters
}

若继续使用旧的javax.persistence注解，Hibernate会无法识别该类为JPA实体。

3. 确保依赖版本一致性 #

检查项目依赖配置，保证所有Spring相关依赖的版本与Spring Boot 3.1.0完全一致：

• Maven项目：通过Spring Boot Parent统一管理版本：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.1.0</version>
    <relativePath/>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <!-- 其他依赖 -->
</dependencies>

• Gradle项目：使用Spring Boot插件管理版本：

plugins {
    id 'org.springframework.boot' version '3.1.0'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    // 其他依赖
}

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