Hibernate 模糊查詢參數化常見陷阱與正確寫法

錯誤現象

在 HQL 中使用 like 進行模糊查詢時，若將萬用字元 % 直接寫在查詢字串或參數中不當，會導致查詢失敗或語法錯誤。

正確寫法

// HQL
from Project o where 1=1 and o.isDeleted = ? and o.prjName like ?

// 參數綁定
query.setString(i, "%" + 實際查詢條件 + "%");

關鍵細節

• 參數值兩側直接加 %，不需單引號："%" + keyword + "%"。這與原生 SQL 不同（SQL 需 '%keyword%'）。
• HQL 中欄位名用實體屬性名（o.prjName），非資料庫欄位名（PRJ_NAME）。

易混淆對照表

最佳實踐

1. 永遠使用參數綁定（setString/setParameter），防止 SQL 注入並利用查詢計畫快取。
2. 萬用字元在 Java 端拼裝："%" + keyword + "%"。
3. 若需轉義 %、_，可用 escape 關鍵字或在 Java 端預處理。

1. 上一篇文章： Java 實現 Google「您是不是要找」拼寫糾錯功能
2. 下一篇文章： Swing 動態載入系統檔案樹：按需讀取解決大量節點效能問題

Java 相關知識

Fire Workflow 源碼深度解析 (一)：核心模型元素與 WorkflowProcess 頂層架構

Fire Workflow 國產開源工作流引擎，源碼分為 `

MyEclipse 基於 XFire 開發 Web Service 完整教程：服務端與客戶端雙向實戰

環境準備 MyEclipse 8.5 XFire 1.2.

Hibernate 性能優化利器：深度解析 FlushMode.NEVER

處理巨量資料（數萬對象）時，Hibernate 預設的自動髒

打造夢幻級 Ruby on Rails 開發環境：Vim + 插件全棧配置指南

作者通過瘋狂配置 Vim，構建出媲美 TextMate 的