JPA 關聯映射深度解析：@OneToMany、@ManyToOne、@ManyToMany 實戰與集合選型指南

前言：關聯映射是 JPA 靈活與複雜並存的核心

正確映射實體關聯，不僅影響 SQL 生成效率，更決定了領域模型的表達力。本文系統梳理三大關聯類型，對比外鍵關聯 vs 關聯表兩種映射策略，深度解析單向 vs 雙向、集合類型選型、級聯與抓取策略，附最佳實踐避雷指南。

一、@OneToMany：一對多

1. 單向一對多：外鍵關聯策略（推薦簡單場景）

表結構：多的一方（Address）持有外鍵 customer_id

CREATE TABLE customer (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100)
);
CREATE TABLE address (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    province VARCHAR(50),
    city VARCHAR(50),
    customer_id BIGINT,  -- 外鍵在多的一方
    FOREIGN KEY (customer_id) REFERENCES customer(id)
);

實體映射：

@Entity
@Table(name = "customer")
public class Customer {
    @Id @GeneratedValue
    private Long id;
    private String name;

    @OneToMany(cascade = CascadeType.ALL)
    @JoinColumn(name = "customer_id") // 指定外鍵列
    private List<Address> addresses = new ArrayList<>();
    // getter/setter
}

@Entity
@Table(name = "address")
public class Address {
    @Id @GeneratedValue
    private Long id;
    private String province;
    private String city;
    // 無需映射 customer 字段（單向）
}

關鍵註解：

• @JoinColumn(name="customer_id")：指定外鍵列名，必須在一的一方聲明
• 無 mappedBy 表示單向，由 Customer 維護關聯
• Hibernate 會發額外 UPDATE 語句維護外鍵（可用 @JoinColumn(insertable=false, updatable=false) 優化）

2. 單向一對多：關聯表策略（解耦、支援多對多演進）

表結構：中間表 customer_address

CREATE TABLE customer_address (
    customer_id BIGINT NOT NULL,
    address_id BIGINT NOT NULL UNIQUE,
    FOREIGN KEY (customer_id) REFERENCES customer(id),
    FOREIGN KEY (address_id) REFERENCES address(id)
);

實體映射：

@Entity
public class Customer {
    @OneToMany(cascade = CascadeType.ALL)
    @JoinTable(
        name = "customer_address",
        joinColumns = @JoinColumn(name = "customer_id", referencedColumnName = "id"),
        inverseJoinColumns = @JoinColumn(name = "address_id", referencedColumnName = "id")
    )
    private List<Address> addresses = new ArrayList<>();
}

優勢：Address 表無外鍵列，領域模型更純淨；易演進為 @ManyToMany。

3. 雙向一對多（最常用、最強大）

多的一方（Address）擁有關聯所有權：

@Entity
public class Address {
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "customer_id")
    private Customer customer;
}

一的一方（Customer）用 mappedBy 放棄維護權：

@Entity
public class Customer {
    @OneToMany(mappedBy = "customer", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private List<Address> addresses = new ArrayList<>();

    // 便利方法：雙向同步
    public void addAddress(Address address) {
        addresses.add(address);
        address.setCustomer(this);
    }
    public void removeAddress(Address address) {
        addresses.remove(address);
        address.setCustomer(null);
    }
}

核心規則：

• mappedBy 值 = 多的一方實體屬性名（customer）
• 關聯維護權在 多的一方（持有外鍵）
• 務必提供雙向同步便利方法，防止關聯不一致

二、@ManyToOne：多對一（關聯擁有方）

通常作為雙向一對多的「多的一方」出現，單向用法同上。默認抓取策略為 EAGER，建議顯式設置 fetch = FetchType.LAZY 避免 N+1 問題。

三、@ManyToMany：多對多

本質是兩個 @OneToMany 的組合，必須使用關聯表。

@Entity
public class Student {
    @ManyToMany
    @JoinTable(
        name = "student_course",
        joinColumns = @JoinColumn(name = "student_id"),
        inverseJoinColumns = @JoinColumn(name = "course_id")
    )
    private Set<Course> courses = new HashSet<>();
}

@Entity
public class Course {
    @ManyToMany(mappedBy = "courses")
    private Set<Student> students = new HashSet<>();
}

注意：多對多雙向同樣需 mappedBy，維護權任選一方，建議在業務主導方維護。

四、集合類型選型指南（影響性能與語義）

五、避雷指南：關聯映射十大坑

1. 缺少 mappedBy：雙向關聯雙方都以為自己是擁有方，生成兩個外鍵/關聯表
2. 預設 EAGER 引發 N+1：@ManyToOne/@OneToOne 默認 EAGER，列表頁查詢爆炸
3. equals/hashCode 未實現或錯誤：Set 去重失效、脫管實體合併異常
4. 級聯刪除誤傷：CascadeType.REMOVE 導致關聯實體被誤刪
5. orphanRemoval 配合不當：從集合移除未孤兒刪除，導致游離實體殘留
6. 雙向同步缺失：單邊設置關聯，另一邊為 null，序列化/查詢不一致
7. 關聯表缺少唯一約束：多對多產生重複關聯記錄
8. fetch=LAZY 但在事務外訪問：LazyInitializationException
9. toString 觸發懶加載：IDE 變量檢視/日誌打印導致意外查詢
10. 忽略批量抓取優化：@BatchSize(size=20) 或 hibernate.default_batch_fetch_size 可大幅減少 N+1

總結

JPA 關聯映射的核心決策矩陣：

掌握這些核心模式與避雷指南，能讓 JPA 關聯映射既符合領域語義，又生成高效 SQL，避免生產環境性能翻車。