在使用 iBATIS(或 MyBatis)編寫動態 SQL 時,參數佔位符的選擇直接關係到應用程式的安全性。許多開發者初次接觸時,容易混淆 # 與 $ 的用法,殊不知一個疏忽就可能導致嚴重的 SQL 注入漏洞。本文透過實測說明兩者的本質差異,並提供最佳實踐建議。
# 參數:安全的預編譯機制當使用 #paramName# 時,iBATIS 會將其轉換為 JDBC 的預編譯參數(PreparedStatement 的 ? 佔位符)。資料庫驅動程式會在 SQL 語句編譯階段就確定執行計畫,使用者輸入的值被視為純資料,而非 SQL 片段。資料庫會自動處理特殊字元(如單引號)的轉義,將其視為字串字面值的一部分,從而有效阻斷 SQL 注入攻擊。
-- 推薦寫法:使用 # 進行模糊查詢
SELECT * FROM t_user WHERE name LIKE '%' || #name# || '%'
$ 參數:危險的直接字串替換相反地,$paramName$ 會在 SQL 發送給資料庫前,直接進行字串替換。使用者輸入的內容會原封不動地拼接進 SQL 語句中,成為 SQL 結構的一部分。若輸入包含單引號或 SQL 關鍵字,極易構成注入攻擊。
-- 禁用寫法:極高風險
SELECT * FROM t_user WHERE name LIKE '%' || '$name$' || '%'
假設使用者輸入 ' OR '1'='1:
#:資料庫查詢 name LIKE '%' || '' OR '1'='1' || '%',將整段視為字串比對,無匹配結果,安全無虞。$:SQL 變為 name LIKE '%' || '' OR '1'='1' || '%',OR '1'='1' 恆真,導致全表資料洩露。SQL 注入的本質是利用特殊字元(特別是單引號)打破 SQL 語句的語法結構,注入惡意邏輯。預編譯機制在 SQL 解析、編譯、優化階段就已完成,參數傳遞僅作為資料綁定,不再經過 SQL 解析器。因此,單引號等特殊字元失去了分隔符的功能,僅被視為普通字元,徹底杜絕了注入可能。
#:所有 WHERE 條件、INSERT/UPDATE 值、IN 列表等,均應使用 #。$ 僅限於無法使用預編譯的場景:如動態指定表名、欄位名、排序欄位(ORDER BY)、分頁關鍵字(LIMIT/OFFSET)等。即便使用,也必須在應用層嚴格驗證輸入(白名單機制)。$ 用法,確保無外部輸入直接傳入。iBATIS/MyBatis 中 # 與 $ 的選擇,不是風格偏好,而是安全底線。牢記「# 為參數,$ 為拼接」,將預編譯作為預設選項,才能在源頭上消除 SQL 注入風險,守護資料資產安全。