多对多关联含额外字段连接表时数据保存失败排查求助

这个NullPointerException的问题其实很好定位——你的Registration实体里的@EmbeddedId字段id没有被初始化，导致Hibernate在尝试通过@MapsId同步用户和课程ID到复合主键时找不到目标对象，直接抛出了空指针。

1. 修复Registration的构造函数，初始化EmbeddedId #

你的Registration构造函数只给user和course赋值了，但完全没管id这个复合主键对象。Hibernate需要这个对象存在，才能把关联实体的ID映射进去。修改构造函数：

public Registration(User user, Course course){
    this.user = user;
    this.course = course;
    // 必须初始化复合主键对象，否则Hibernate无法设置userId和courseId
    this.id = new UserCourseId();
}

2. 修正客户端代码里的笔误 #

看你的客户端代码，User.builder()里写了.address(new HashSet<>())，但你的User类根本没有address字段，应该是.courses(new HashSet<>())——虽然你的registerCourse方法里会判断courses是否为null并初始化，但修正这个笔误能避免不必要的空指针风险：

User johnDoe = User.builder()
        .firstName("John")
        .lastName("Doe")
        .emailAddress("johndoe22@gmail.com")
        .courses(new HashSet<>()) // 把address改成courses
        .build();

额外的优化建议（可选） #

为了让代码更健壮，你可以做以下优化：

• 给Registration添加完整的构造函数，直接初始化复合主键的初始值（Hibernate最终会覆盖它，但能避免潜在问题）：

public Registration(User user, Course course, LocalDate registeredDate, int percentageCompleted){
    this.user = user;
    this.course = course;
    this.id = new UserCourseId(user.getUserId(), course.getId());
    this.registeredDate = registeredDate;
    this.percentageCompleted = percentageCompleted;
}

• 给registeredDate设置默认值，避免保存时出现null：

@Column(name = "registration_date")
private LocalDate registeredDate = LocalDate.now();

这样修改后，再运行你的保存代码，应该就能正常持久化用户、课程和关联的Registration记录了。

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