Spring Data JPA报错：Book类非托管类型问题求助

报错信息 #

Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled.
2024-03-14T03:14:28.239+04:00 ERROR 15000 --- [Assignment] [           main] o.s.boot.SpringApplication               : Application run failed

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'bookController' defined in file [C:\Users\gulma\Desktop\as1-spring-boot-jpa-app-mammadmammadov\build\classes\java\main\az\edu\ada\wm2\Assignment\controller\BookController.class]: Unsatisfied dependency expressed through constructor parameter 0: Error creating bean with name 'bookRepository' defined in az.edu.ada.wm2.Assignment.repository.BookRepository defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Not a managed type: class az.edu.ada.wm2.Assignment.model.Book
    ...
Caused by: java.lang.IllegalArgumentException: Not a managed type: class az.edu.ada.wm2.Assignment.model.Book

问题说明 #

开发Spring Boot+Spring Data JPA应用时，启动报错提示az.edu.ada.wm2.Assignment.model.Book不是JPA托管类型，但已在Book类上添加@Entity注解。项目根包为az.edu.ada.wm2.Assignment，下包含controller、model、repository等子包。

实体类代码 #

Book类 #

package az.edu.ada.wm2.Assignment.model;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import javax.persistence.*;
import java.util.HashSet;
import java.util.Set;

@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
@Table(name = "books")
public class Book {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "book_id")
    private Integer id;

    @Column(name = "book_name")
    private String name;

    @Column(name = "book_rating")
    private Integer rating;

    @ManyToMany
    @JoinTable(
            name = "authors",
            joinColumns = @JoinColumn(name = "book_id"),
            inverseJoinColumns = @JoinColumn(name = "author_id")
    )
    private Set<Author> authors;

    public Book(String name, Integer rating) {
        this.name = name;
        this.rating = rating;
    }
}

Author类 #

package az.edu.ada.wm2.Assignment.model;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import javax.persistence.*;
import java.util.HashSet;
import java.util.Set;

@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
@Table(name = "authors")
public class Author {

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

    @Column(name = "author_name")
    private String name;

    @ManyToMany(mappedBy = "authors")
    private Set<Book> books = new HashSet<>();

    public Author(String name) {
        this.name = name;
    }
}

问题分析与解决办法 #

核心原因 #

Not a managed type错误本质是Spring Data JPA未扫描到实体类，或实体类配置存在冲突，常见触发场景：

1. 主启动类所在包未覆盖实体类的model子包
2. @EnableJpaRepositories/@EntityScan的包路径配置错误
3. 实体类注解导入错误，或多对多关联表配置冲突

具体解决步骤 #

1. 检查主启动类位置与扫描配置
   Spring Boot默认扫描主启动类所在包及其子包，若主启动类不在根包az.edu.ada.wm2.Assignment下，需手动指定扫描范围：

   @SpringBootApplication
   @EntityScan(basePackages = "az.edu.ada.wm2.Assignment.model")
   @EnableJpaRepositories(basePackages = "az.edu.ada.wm2.Assignment.repository")
   public class AssignmentApplication {
       public static void main(String[] args) {
           SpringApplication.run(AssignmentApplication.class, args);
       }
   }
   

2. 修正多对多关联表冲突
   Book类中@JoinTable的name设置为authors，但该名称已被Author实体的表占用，需改为中间关联表名称（如book_author）：

   @ManyToMany
   @JoinTable(
           name = "book_author",
           joinColumns = @JoinColumn(name = "book_id"),
           inverseJoinColumns = @JoinColumn(name = "author_id")
   )
   private Set<Author> authors;
   

3. 验证注解导入正确性
   确保实体类导入的是JPA标准注解：

   • Spring Boot 2.x使用import javax.persistence.Entity;
   • Spring Boot 3.x使用import jakarta.persistence.Entity;（JPA包已迁移至jakarta）

4. 清理缓存并重建项目
   清理项目构建目录（build/target），执行mvn clean install（Maven）或./gradlew clean build（Gradle），重启IDE后重新运行应用。

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