MySQL 已建外鍵，Hibernate 實體類還需映射關聯嗎？

結論先行

必須映射。資料庫外鍵只保證數據完整性，Hibernate 需要實體類映射才能導航關聯、級聯操作、延遲加載等 ORM 功能。

註解映射範例（一對多 / 多對一）

@Entity
@Table(name = "orders")
public class Order {
    @Id @GeneratedValue
    private Long id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id", foreignKey = @ForeignKey(name = "fk_order_user"))
    private User user;  // 多對一：訂單屬於用戶
}

// 反向導航（可選）
@Entity
@Table(name = "users")
public class User {
    @Id @GeneratedValue
    private Long id;

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<Order> orders = new ArrayList<>(); // 一對多：用戶擁有訂單
}

關鍵註解解析

手寫實體 vs 自動生成

• 手寫實體：完全可控，需手動同步 DB 變更，適合領域驅動設計
• 自動生成：JPA Buddy / Hibernate Tools 逆向工程，適合舊系統遷移

常見坑

1. 雙向關聯未同步：user.getOrders().add(order); order.setUser(user); 兩邊都要 set
2. 懶加載異常：Session 關閉後訪問關聯 → 用 @EntityGraph 或 DTO 投影查詢
3. @JoinColumn 重複定義：雙向關聯僅在擁有方（含外鍵的一方）定義

總結

DB 外鍵 ≠ ORM 映射。實體類必須聲明 @ManyToOne/@OneToMany 等註解，Hibernate 才能提供物件導航、級聯持久化、JPQL 關聯查詢等核心能力。手寫實體時務必注意雙向同步與加載策略，避免 N+1 與懶加載異常。