Hibernate 一對多雙向關聯：空指針異常的根因與正確雙向維護順序

Hibernate 一對多雙向關聯中，「一」的一方 (Group) 持有集合，「多」的一方 (User) 持有單向引用。保存時拋出空指針，根因是「一」的一方集合未初始化，且雙向關聯維護順序錯誤。

錯誤代碼分析

Group g = new Group();
g.setName("g1");
// ❌ g.getUsers() 返回 null，未初始化集合
g.getUsers().add(u); // NPE!

User u = new User();
u.setName("u1");
u.setGroup(g); // 設置反向引用
g.getUsers().add(u); // 這裡其實已晚了，集合可能仍為 null

實體類正確定義

// Group.java (一的一方)
@Entity
public class Group {
    @Id @GeneratedValue
    private Long id;
    private String name;
    
    @OneToMany(mappedBy = "group", cascade = CascadeType.ALL, orphanRemoval = true)
    // 初始化集合，避免 NPE
    private Set users = new HashSet<>(); 
    
    // 便利方法：雙向綁定 (核心最佳實踐)
    public void addUser(User user) {
        users.add(user);
        user.setGroup(this); // 維護反向引用
    }
    
    public void removeUser(User user) {
        users.remove(user);
        user.setGroup(null);
    }
    // getters/setters
}

// User.java (多的一方)
@Entity
public class User {
    @Id @GeneratedValue
    private Long id;
    private String name;
    
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "group_id")
    private Group group;
    // getters/setters
}

正確使用姿勢

Group g = new Group();
g.setName("g1");

User u1 = new User();
u1.setName("u1");

User u2 = new User();
u2.setName("u2");

// ✅ 使用便利方法，自動雙向綁定
g.addUser(u1);
g.addUser(u2);

// 只需保存「一」的一方，cascade=ALL 會級聯保存「多」的一方
session.save(g); 
transaction.commit();

關鍵點總結

進階：為什麼要在「一」的一方維護關聯？

• mappedBy = "group" 表示關聯由 User 端的 group 字段維護 (外鍵在 User 表)
• Group 端的 users 集合是視圖，非數據庫物理列
• Hibernate 只檢查「擁有方」 (User.group) 同步到數據庫
• 但為了對象圖一致性、級聯操作、記憶體中導航，**必須手動同步「非擁有方」集合**

最佳實踐檢查清單

1. 集合字段聲明處初始化 (new HashSet<>())
2. 提供 addXxx/removeXxx 便利方法，內部雙向綁定
3. 配置 cascade = ALL, orphanRemoval = true
4. equals/hashCode 僅基於 ID (或業務鍵)，不包含集合字段
5. 序列化排除反向引用 (@JsonIgnore / @ToString.Exclude)
6. 測試：保存、更新、刪除、孤兒刪除、雙向導航全覆蓋

掌握「便利方法雙向綁定」模式，是 Hibernate/JPA 避開 90% 一對多坑點的核心鑰匙。