MySQL + Hibernate：實體字段與關鍵字衝突的優雅解法——反引號轉義

MySQL + Hibernate：實體字段與關鍵字衝突的優雅解法——反引號轉義

場景：MySQL 表字段名 usage 是保留字，Hibernate 生成 SQL 未轉義導致語法錯誤：

ERROR: You have an error in your SQL syntax near 'usage' at line 1

快速修復：映射文件加反引號

<hibernate-mapping>
  <class name="com.entity.Test" table="test">
    <id name="id" column="id"><generator class="native"/></id>
    <!-- 關鍵：column 屬性值用反引號包裹 -->
    <property name="usage" column="`usage`" type="string" length="1"/>
  </class>
</hibernate-mapping>

• ` 為鍵盤左上角 ~ 鍵，**非單引號 '**。
• Hibernate 將原樣輸出到 SQL：SELECT `usage` FROM test，MySQL 正確識別為標識符。
• 無需修改實體類字段名、表結構、DAO 代碼，**零侵入修復**。

為何不建議長期依賴此方案？

1. 代碼生成器會覆蓋：逆向工程生成實體/映射時**不會自動加反引號**，再次生成即復發。
2. 團隊維護成本高：新成員不知情，改動映射文件後忘記加反引號。
3. 可移植性差：遷移到 Oracle/PostgreSQL 時反引號語法不同（Oracle 用雙引號 "usage"，PG 同）。

根治建議：命名規範預防

註解配置寫法

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

    @Column(name = "`usage`") // 同理加反引號
    private String usage;
    // getter/setter
}

總結

反引號是止痛藥，規範命名才是根治方案。 緊急上線可用反引號救急，事後務必納入技術債清單，下個迭代重構字段名。

1. 上一篇文章： jQuery AJAX 三大核心方法實戰：load / $.post / $.ajax 與 Struts2 整合
2. 下一篇文章： Java 文件複製與剪切實戰：從基礎 IO 到 NIO.2 的進階指南

Java 綜合教學

Java 並發編程入門：深入理解進程與線程的核心差異

並發與並行：基礎概念辨析 在踏入 Java 並發編程的大門前

Java 面向對象三大特性深度解析：封裝、繼承與多態

一、封裝 定義 將數據（屬性）與操作數據的方法綁定在一起，對

Java 反編譯神器 JD-GUI 使用全攻略：從 JAR 到源碼一鍵還原

前言：為什麼需要反編譯？ Eclipse 開發時常遇到「點進

主流 Java 框架整合方案：Spring MVC + MyBatis + WebSocket 企業級服務端架構

企業級 Java 服務端框架整合實戰 在現代企業級應用開發中