未显式声明唯一键时，如何用JPA关联两张表？报错排查

一、JPA关联配置修正（未显式声明唯一键变量的情况） #

首先，你的实体类缺少主键id的声明——这是JPA实体的强制要求，不管是否显式声明额外的唯一键，数据库的主键必须映射到实体的主键字段，否则JPA无法识别实体的唯一标识。以下是修正后的实体代码：

1. Book实体修正 #

@Entity(name = "book")
public class Book {
    // 补全主键，对应数据库book.id字段
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY) // 适配数据库自增主键策略
    private Long id;

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

    // 修正ManyToOne关联：移除insertable=false, updatable=false，让JPA维护外键的插入与更新
    @ManyToOne(fetch = FetchType.LAZY) // 建议用懒加载避免不必要的关联查询
    @JoinColumn(name = "student_id") // 外键对应book.student_id，关联student.id
    private Student student;

    // 补充getter、setter、构造方法
}

2. Student实体修正 #

@Entity(name = "student")
public class Student {
    // 补全主键，对应数据库student.id字段
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "student_name")
    private String studentName; // 统一驼峰命名，避免与数据库字段名混淆

    // OneToMany关联：mappedBy指向Book实体中的student属性，明确关联关系的维护端是Book
    @OneToMany(mappedBy = "student", fetch = FetchType.LAZY)
    private List<Book> books; // 变量名改为复数更符合语义

    // 补充getter、setter、构造方法
}

关键说明：

• 必须用@Id标注主键字段，这是JPA实体的核心要求；
• 移除Book中@JoinColumn的insertable=false, updatable=false：保留这两个属性会导致JPA无法通过Book实体维护外键，引发数据关联异常；
• 加入fetch = FetchType.LAZY：默认的立即加载（EAGER）会导致查询Book时自动加载关联的Student，容易引发性能问题，懒加载更符合多数业务场景。

二、解决JpaObjectRetrievalFailureException报错 #

这个报错的核心原因是：book表中存在student_id为7402的记录，但student表中没有id=7402的学生数据，JPA加载Book实体并关联Student时，找不到对应的Student实例，因此抛出异常。

解决步骤：

1. 修复数据一致性

   • 先执行SQL找出book表中所有无效的外键记录：

     SELECT * FROM book WHERE student_id NOT IN (SELECT id FROM student);
     

   • 针对无效数据，二选一处理：
     • 若这些图书属于已删除的学生，直接删除对应Book记录：

       DELETE FROM book WHERE student_id NOT IN (SELECT id FROM student);
       

     • 若为数据录入错误，修正student_id为存在的学生ID：

       UPDATE book SET student_id = 有效学生ID WHERE student_id = 7402;
       

2. 优化关联查询容错性（可选）
   如果业务允许图书存在“未被借阅”的状态（即student_id可为空），可以修改Book实体的关联配置，允许Student为null：

   @ManyToOne(fetch = FetchType.LAZY, optional = true) // optional=true允许关联对象为空
   @JoinColumn(name = "student_id")
   private Student student;
   

   这样当book表的student_id为空或无对应Student时，JPA不会抛出异常，而是将Book的student属性设为null。

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