Spring JPA报错：OneToMany关联未映射类，请求排查注解问题

从你提供的代码和报错信息来看，问题的核心很清晰：你的Loan类缺少@Entity注解，导致Hibernate无法将它识别为需要映射到数据库的持久化实体，所以当Book和Customer类的@OneToMany关联指向它时，就抛出了@OneToMany指向未映射类的异常。

问题根源拆解 #

JPA规范要求所有参与ORM映射的实体类必须标注@Entity注解，否则Hibernate不会将该类纳入持久化上下文管理。你的Loan类虽然定义了嵌入式主键LoanId，但本身没有被标记为实体，这就导致关联它的@OneToMany注解找不到对应的映射类，最终触发初始化ICustomerDao Bean时的异常。

修复方案及细节调整 #

1. 给Loan类添加@Entity注解 #

这是最关键的一步，显式告诉Hibernate这个类是需要映射的实体：

@Entity
@Table(name = "LOAN") // 根据你的实际数据库表名调整，建议显式指定
public class Loan implements Serializable {
    // 省略属性及Getter/Setter
    @EmbeddedId
    public LoanId getPk() { return pk; }
}

2. 修正Book类的@OneToMany关联配置 #

你之前的mappedBy = "pk"是错误的，在复合主键的关联关系中，mappedBy需要指向嵌入式主键内关联当前实体的属性，而非主键对象本身。假设LoanId里关联Book的属性是book，那么需要修改为：

@Entity 
@Table(name = "BOOK")
public class Book {
    // 省略属性及Getter/Setter
    @OneToMany(fetch = FetchType.LAZY, mappedBy = "pk.book", cascade = CascadeType.ALL)
    public Set<Loan> getLoans() { return loans; }
}

3. 确保LoanId类的关联配置正确 #

嵌入式主键类里的关联字段需要标注@ManyToOne，并指定外键列名，同时这个类必须实现equals()和hashCode()方法（复合主键的强制要求）：

@Embeddable
public class LoanId implements Serializable {
    @ManyToOne
    @JoinColumn(name = "BOOK_ID") // 对应BOOK表的主键列名
    private Book book;

    @ManyToOne
    @JoinColumn(name = "CUSTOMER_ID") // 对应CUSTOMER表的主键列名
    private Customer customer;

    // 省略Getter/Setter
    // 必须实现equals()和hashCode()方法
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        LoanId loanId = (LoanId) o;
        return Objects.equals(book, loanId.book) && Objects.equals(customer, loanId.customer);
    }

    @Override
    public int hashCode() {
        return Objects.hash(book, customer);
    }
}

最后检查点 #

• 确认所有实体类都在@EnableJpaRepositories指定的扫描包路径下，避免Hibernate无法扫描到实体
• 检查数据库表结构是否和实体映射配置一致（比如外键列名、表名）

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