Hibernate「Repeated column in mapping」異常根因與四種解決方案

Hibernate「Repeated column in mapping」異常根因與四種解決方案

在雙向一對多關聯映射中，Repeated column in mapping for entity 是高頻報錯。本文通過實例深度剖析異常產生機制，並給出四種修復方案與最佳實踐建議。

場景還原：Item-Bid 雙向一對多

// Item.java
public class Item {
    private int id;
    private String name;
    private Set<Bid> bids = new HashSet<>();
}

// Bid.java
public class Bid {
    private int id;
    private double amount;
    private Item item;
}

Item.hbm.xml（一端）

<set name="bids" table="t_bid" cascade="save-update">
    <key column="item_id" not-null="true"/>  <!-- 關鍵點 -->
    <one-to-many class="value.Bid"/>
</set>

Bid.hbm.xml（多端）

<many-to-one name="item" class="value.Item" column="item_id" not-null="true" />

測試代碼

Item item = new Item(); item.setName("item");
Bid b1 = new Bid(); b1.setAmount(12.09); b1.setItem(item);
Bid b2 = new Bid(); b2.setAmount(11.98); b2.setItem(item);
Set<Bid> bids = new HashSet<>(); bids.add(b1); bids.add(b2);
item.setBids(bids);
session.save(item); // 拋出異常

異常堆疊

org.hibernate.MappingException: 
Repeated column in mapping for entity: value.Bid column: item_id 
(should be mapped with insert="false" update="false")

根因深度剖析

(1) <key not-null="true"> 的副作用

在 <key> 元素上指定 not-null="true"，告訴 Hibernate：「外鍵列 item_id 在資料庫層面不可為 NULL」。為滿足此約束，**Item 端（一端）會在 INSERT 語句中顯式包含 item_id 列**並賦值。

對比：

• 無 not-null：insert into t_bid (amount) values (?)
• 有 not-null="true"：insert into t_bid (amount, item_id) values (?, ?)

(2) 多端 <many-to-one> 默認行為

Bid 端的 <many-to-one column="item_id"> 同樣會在 INSERT 中包含 item_id（即使值為 NULL）。

(3) 衝突時刻

Hibernate 生成 SQL 變為：
insert into t_bid (item_id, item_id, amount) values (?, ?, ?)
列名重複 → 拋出 Repeated column 異常。

四種解決方案優劣對比

最佳實踐建議

1. 首選方案 3：在 <set inverse="true">，語義明確「由多端控制關聯」，配合資料庫 DDL 維護 NOT NULL 約束。
2. 若業務要求一端可獨立維護關聯（極少見），採用方案 2 並在代碼層面雙向同步對象圖。
3. 永不使用方案 4，會導致資料冗餘與不一致風險。
4. 映射文件中 避免在 <key> 設置 not-null="true"，除非極其確定單向關聯且無級聯保存。

補充：inverse="true" 的副作用與應對

開啟 inverse="true" 後，若僅設置 item.setBids(bids) 而未設置 bid.setItem(item)，外鍵將不會持久化。解決方式：

• 在 Item.addBid(Bid bid) 方法中雙向綁定：bids.add(bid); bid.setItem(this);
• 或使用 JPA @OneToMany(mappedBy="item") 註解，由提供者自動管理。