Spring Boot 3中@EmbeddedId关联@ManyToMany实体的持久化问题

核心结论 #

必须先持久化Meeting和Document实体，获取它们的数据库ID后，再创建并保存中间关联实体RelDocumentMeeting，无法直接一步完成三者的同时创建。

原因分析 #

你的中间实体RelDocumentMeeting使用@EmbeddedId作为复合主键，这个主键必然包含meeting_id和document_id两个外键字段。而新创建的Meeting和Document未经过持久化时，还没有生成数据库层面的ID（比如自增ID），Hibernate无法为中间表的外键字段赋值，最终导致类型转换异常（通常是尝试将临时状态的实体对象转换为ID类型失败）。

具体实现步骤 #

1. 单独保存新的Meeting实例，获取持久化后的ID：

Meeting newMeeting = new Meeting();
// 设置Meeting的其他属性
meetingRepository.save(newMeeting);

2. 单独保存新的Document实例，获取持久化后的ID：

Document newDocument = new Document();
// 设置Document的其他属性
documentRepository.save(newDocument);

3. 创建中间关联实体，设置复合主键并保存：

RelDocumentMeetingId id = new RelDocumentMeetingId();
id.setMeetingId(newMeeting.getId());
id.setDocumentId(newDocument.getId());

RelDocumentMeeting relation = new RelDocumentMeeting();
relation.setId(id);
// 如果中间表有额外字段，在这里设置
relDocumentMeetingRepository.save(relation);

简化方案（如果中间表无额外字段） #

如果你的中间表relation_document_meeting仅用于关联，没有额外业务字段，可以放弃中间实体，直接使用@ManyToMany注解配置关联，Hibernate会自动处理三者的同时创建：

Meeting实体配置 #

@Entity
public class Meeting {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他属性

    @ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
    @JoinTable(
        name = "relation_document_meeting",
        joinColumns = @JoinColumn(name = "meeting_id"),
        inverseJoinColumns = @JoinColumn(name = "document_id")
    )
    private Set<Document> documents = new HashSet<>();

    // getter、setter
}

Document实体配置 #

@Entity
public class Document {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他属性

    @ManyToMany(mappedBy = "documents")
    private Set<Meeting> meetings = new HashSet<>();

    // getter、setter
}

保存操作 #

Meeting newMeeting = new Meeting();
Document newDocument = new Document();

newMeeting.getDocuments().add(newDocument);
newDocument.getMeetings().add(newMeeting);

meetingRepository.save(newMeeting);

此时Hibernate会自动插入Meeting、Document记录，并生成中间表的关联数据。

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