Spring Boot JPA启动报错：Availability非托管类型问题求助

报错信息 #

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'availabilityRepository' defined in com.island.lendingportal.repository.AvailabilityRepository defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Not a managed type: class com.island.lendingportal.model.Availability

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'availabilityService' defined in file [C:\Users\Lucas\IdeaProjects\javap3\lending-portal\target\classes\com\island\lendingportal\service\AvailabilityService.class]: Unsatisfied dependency expressed through constructor parameter 0: Error creating bean with name 'availabilityRepository' defined in com.island.lendingportal.repository.AvailabilityRepository defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Not a managed type: class com.island.lendingportal.model.Availability

Caused by: java.lang.IllegalArgumentException: Not a managed type: class com.island.lendingportal.model.Availability
at org.hibernate.metamodel.model.domain.internal.JpaMetamodelImpl.managedType(JpaMetamodelImpl.java:193) ~[hibernate-core-6.3.1.Final.jar:6.3.1.Final]
at org.hibernate.metamodel.model.domain.internal.MappingMetamodelImpl.managedType(MappingMetamodelImpl.java:463) ~[hibernate-core-6.3.1.Final.jar:6.3.1.Final]
at org.hibernate.metamodel.model.domain.internal.MappingMetamodelImpl.managedType(MappingMetamodelImpl.java:97) ~[hibernate-core-6.3.1.Final.jar:6.3.1.Final]

相关代码 #

初始Availability模型代码 #

package com.island.lendingportal.model;
import javax.persistence.*;
import java.sql.Date;

@Entity
@Table(name = "availability")
public class Availability {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "availability_ID")
    private Long availabilityId;

    @ManyToOne
    @JoinColumn(name = "item_ID", nullable = false)
    private Item item;

    @ManyToOne
    @JoinColumn(name = "user_ID")
    private User user;

    @Column(name = "availStartDate")
    private Date availStartDate;

    @Column(name = "availEndDate")
    private Date availEndDate;

    @Column(name = "isBooked")
    private boolean isBooked;

//and then constructors, getters and setters

项目启动类代码 #

package com.island;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.ComponentScan;

@SpringBootApplication
@EntityScan(basePackages = "com.island.lendingportal.model")
@ComponentScan(basePackages = "com.island.lendingportal.service")
public class LendingPortalApplication {
    public static void main(String[] args) {
        SpringApplication.run(LendingPortalApplication.class, args);
    }
}

AvailabilityRepository代码 #

package com.island.lendingportal.repository;

import com.island.lendingportal.model.Availability;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface AvailabilityRepository extends JpaRepository<Availability, Long> {
    // You can add custom query methods here if needed
}

完整Availability模型代码 #

package com.island.lendingportal.model;

import jakarta.persistence.*;
import java.sql.Date;

@Entity
@Table(name = "availability")
public class Availability {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "availability_ID")
    private Long availabilityId;

    @ManyToOne
    @JoinColumn(name = "item_ID", nullable = false)
    private Item item;

    @ManyToOne
    @JoinColumn(name = "user_ID")
    private User user;

    @Column(name = "availStartDate")
    private Date availStartDate;

    @Column(name = "availEndDate")
    private Date availEndDate;

    @Column(name = "isBooked")
    private boolean isBooked;

    // Constructors, getters, and setters

    public void setItem(Item item) {
        this.item = item;
    }

    public Long getAvailabilityId() {
        return availabilityId;
    }

    public void setAvailabilityId(Long availabilityId) {
        this.availabilityId = availabilityId;
    }

    public Item getItem() {
        return item;
    }

    public void setUser(User user) {
        this.user = user;
    }

    public User getUser() {
        return user;
    }

    public void setAvailStartDate(Date availStartDate) {
        this.availStartDate = availStartDate;
    }

    public Date getAvailStartDate() {
        return availStartDate;
    }

    public void setAvailEndDate(Date availEndDate) {
        this.availEndDate = availEndDate;
    }

    public Date getAvailEndDate() {
        return availEndDate;
    }

    public void setBooked(boolean booked) {
        isBooked = booked;
    }

    public boolean isBooked() {
        return isBooked;
    }
}

问题排查与解决方案 #

核心问题分析 #

报错提示Not a managed type，说明Spring Data JPA无法识别Availability实体类为JPA管理的实体，主要原因有两个：

1. JPA注解包冲突：你的Hibernate版本是6.3.1，属于Jakarta EE 9+版本，该版本已将JPA注解从javax.persistence迁移到jakarta.persistence。代码中初始模型用javax.persistence.*，完整模型用jakarta.persistence.*，混用会导致实体无法被识别。
2. Repository扫描范围缺失：启动类仅配置了实体和服务类的扫描，未配置@EnableJpaRepositories指定Repository所在包，Spring无法扫描到AvailabilityRepository并关联实体。

具体修复步骤 #

1. 统一JPA注解包：确保所有实体类（包括Item、User）都使用jakarta.persistence.*包下的注解，删除javax.persistence.*的导入语句。
2. 补充Repository扫描配置：在启动类上添加@EnableJpaRepositories注解，指定Repository所在包路径：

package com.island;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EntityScan(basePackages = "com.island.lendingportal.model")
@ComponentScan(basePackages = "com.island.lendingportal.service")
@EnableJpaRepositories(basePackages = "com.island.lendingportal.repository")
public class LendingPortalApplication {
    public static void main(String[] args) {
        SpringApplication.run(LendingPortalApplication.class, args);
    }
}

3. 清理重构项目：执行mvn clean install（或IDEA中执行Clean Project + Rebuild Project），确保编译后的class文件为更新版本，避免旧代码残留。

额外检查点 #

• 确认Spring Boot与Hibernate版本兼容：Spring Boot 3.x对应Hibernate 6.x（Jakarta EE），Spring Boot 2.x对应Hibernate 5.x（Java EE），版本不匹配会引发注解识别问题。
• 检查Item和User实体类是否添加了@Entity注解，且使用jakarta.persistence包，否则关联关系也会触发错误。

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