Hibernate 雙向多對多關聯映射完整指南：配置、關聯維護、級聯與反向控制

Hibernate 雙向多對多關聯映射完整指南：配置、關聯維護、級聯與反向控制

多對多關聯是領域模型中常見關係 (學生-課程、用戶-角色、訂單-商品)。Hibernate 通過中間表 (關聯表) 實現雙向多對多映射。本文以「學生-課程」為例，系統講解映射配置、inverse 反向控制、級聯操作、關聯維護最佳實踐與常見陷阱。

一、領域模型設計

// Student.java
public class Student {
    private Long id;
    private String name;
    private Set<Course> courses = new HashSet<>();  // 多對多關聯集合
    // getter/setter 省略
}

// Course.java
public class Course {
    private Long id;
    private String name;
    private Set<Student> students = new HashSet<>();  // 反向關聯集合
    // getter/setter 省略
}

二、數據庫表結構 (三張表)

-- 學生表
CREATE TABLE students (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) NOT NULL
);

-- 課程表
CREATE TABLE courses (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) NOT NULL
);

-- 關聯表 (中間表) - 聯合主鍵
CREATE TABLE students_courses (
    student_id BIGINT NOT NULL,
    course_id BIGINT NOT NULL,
    PRIMARY KEY (student_id, course_id),
    FOREIGN KEY (student_id) REFERENCES students(id),
    FOREIGN KEY (course_id) REFERENCES courses(id)
);

三、Hibernate 映射文件配置 (HBM XML)

1. Student.hbm.xml

<hibernate-mapping>
    <class name="com.example.Student" table="students">
        <id name="id" column="id">
            <generator class="native"/>
        </id>
        <property name="name" column="name"/>
        
        <!-- 雙向多對多：Student 為關係維護端 (inverse=false 默認) -->
        <set name="courses" table="students_courses" cascade="save-update">
            <key column="student_id"/>
            <many-to-many class="com.example.Course" column="course_id"/>
        </set>
    </class>
</hibernate-mapping>

2. Course.hbm.xml

<hibernate-mapping>
    <class name="com.example.Course" table="courses">
        <id name="id" column="id">
            <generator class="native"/>
        </id>
        <property name="name" column="name"/>
        
        <!-- 反向端：inverse=true 放棄關係維護權 -->
        <set name="students" table="students_courses" cascade="save-update" inverse="true">
            <key column="course_id"/>
            <many-to-many class="com.example.Student" column="student_id"/>
        </set>
    </class>
</hibernate-mapping>

四、關鍵配置屬性解析

五、inverse 反向控制核心機制 (必須掌握)

inverse="false" (默認)：該端負責維護關係，會對中間表執行 INSERT/UPDATE/DELETE

inverse="true"：該端放棄維護關係，不會操作中間表，僅作為查詢導航

雙向多對多鐵律：必須一方 inverse=true，另一方 inverse=false

場景驗證

Student s = new Student(); s.setName("李四");
Course c1 = new Course(); c1.setName("英語");
Course c2 = new Course(); c2.setName("數學");

// 建立雙向關聯 (雙邊都添加，保證對象圖一致性)
s.getCourses().add(c1); s.getCourses().add(c2);
c1.getStudents().add(s); c2.getStudents().add(s);

session.save(c1); session.save(c2); session.save(s);

六、關聯操作最佳實踐

1. 新增關聯 (雙邊同步)

// 正確姿勢：雙邊添加，由維護端持久化
Student s = session.get(Student.class, 1L);
Course c = session.get(Course.class, 2L);

s.getCourses().add(c);      // 維護端操作會同步到中間表
c.getStudents().add(s);     // 反向端僅為對象圖一致性

session.saveOrUpdate(s);    // 或 save(c) 視級聯配置

2. 移除關聯

// 僅移除關聯，不刪除實體
Student s = session.get(Student.class, 1L);
Course c = session.get(Course.class, 2L);

s.getCourses().remove(c);   // 維護端移除 → 中間表 DELETE
c.getStudents().remove(s);  // 反向端同步

// 級聯刪除實體 (慎用 cascade="delete" 或 "all")
session.delete(s);  // 若 cascade 包含 delete，會刪除中間表記錄，但不會刪除 Course 實體

3. 查詢關聯

// 查詢學生的所有課程 (延遲加載默認)
Student s = session.get(Student.class, 1L);
Set<Course> courses = s.getCourses();  // 觸發查詢中間表 JOIN courses

// 查詢課程的所有學生
Course c = session.get(Course.class, 2L);
Set<Student> students = c.getStudents();

七、註解配置對應 (JPA/Hibernate Annotation)

// Student.java (維護端)
@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
@JoinTable(
    name = "students_courses",
    joinColumns = @JoinColumn(name = "student_id"),
    inverseJoinColumns = @JoinColumn(name = "course_id")
)
private Set<Course> courses = new HashSet<>();

// Course.java (反向端)
@ManyToMany(mappedBy = "courses")  // mappedBy 指向維護端屬性名
private Set<Student> students = new HashSet<>();

八、拆解為雙向一對多 (替代方案)

若需在中間表存儲額外屬性 (如選課時間、成績)，必須拆解為兩個一對多：

// 中間實體
@Entity
@Table(name = "students_courses")
public class StudentCourse {
    @EmbeddedId
    private StudentCourseId id;  // 聯合主鍵
    
    @ManyToOne
    @MapsId("studentId")
    @JoinColumn(name = "student_id")
    private Student student;
    
    @ManyToOne
    @MapsId("courseId")
    @JoinColumn(name = "course_id")
    private Course course;
    
    private LocalDateTime enrollTime;
    private Double score;
    // ...
}

九、常見陷阱與避坑指南

十、效能優化建議

1. 集合類型選擇：Set 去重語義符合多對多，List 需 @OrderColumn 維護索引開銷大
2. 延遲加載：默認 lazy=true，避免載入大量關聯數據
3. 批量抓取：@BatchSize(size=20) 或 hibernate.default_batch_fetch_size 減少 N+1 查詢
4. 維護端選擇：選擇集合較小的一端作維護端 (inverse=false)，減少中間表操作
5. 避免全量加載：大集合查詢用 HQL/Criteria 分頁或 @LazyCollection(LazyCollectionOption.EXTRA)

核心心法：雙向多對多的靈魂是 inverse 屬性。「誰維護，誰負責中間表增刪改」。維護端 (inverse=false) 操作集合會同步到數據庫；反向端 (inverse=true) 僅為導航查詢。雙邊在內存中同步添加/移除，保證對象圖一致性。選擇集合較小端作維護端是效能優化鐵律。

掌握雙向多對多映射，不僅能正確持久化複雜關係，更能在排查關聯數據丟失、重複插入、級聯刪除異常時直指本質。