Oracle MD5 加密完整指南：從核心套件到自訂函數實作

Oracle MD5 加密完整指南：從核心套件到自訂函數實作

Oracle 資料庫內建 DBMS_OBFUSCATION_TOOLKIT 套件提供 MD5 雜湊功能，但直接呼叫有諸多限制。本文深入解析核心技術細節，提供可直接部署的自訂函數範例，解決 SQL 語句中直接使用的難題。

核心技術點解析

1. DBMS_OBFUSCATION_TOOLKIT.MD5 限制

此函數回傳 RAW 型別資料，且無法直接在 SQL 查詢中呼叫，僅能在 PL/SQL 區塊或預存程序中使用。嘗試直接執行 SELECT DBMS_OBFUSCATION_TOOLKIT.MD5(input_string => 'abc') FROM dual 會報錯。

2. 型別轉換關鍵：UTL_RAW.CAST_TO_RAW

MD5 運算結果為 RAW 型別，需搭配 UTL_RAW.CAST_TO_RAW 或 RAWTOHEX 轉換為可讀字串。嵌套呼叫時，每層呼叫後都必須轉換，否則最終結果錯誤。

實作方案一：PL/SQL 區塊直接呼叫

DECLARE
  v_hash VARCHAR2(32);
BEGIN
  v_hash := UTL_RAW.CAST_TO_RAW(
              SYS.DBMS_OBFUSCATION_TOOLKIT.MD5(input_string => '111')
            );
  DBMS_OUTPUT.PUT_LINE(v_hash);
END;
/

實作方案二：建立可在 SQL 中呼叫的包裝函數（推薦）

CREATE OR REPLACE FUNCTION MD5(passwd IN VARCHAR2) RETURN VARCHAR2 IS
  retval VARCHAR2(32);
BEGIN
  retval := UTL_RAW.CAST_TO_RAW(
              DBMS_OBFUSCATION_TOOLKIT.MD5(INPUT_STRING => passwd)
            );
  RETURN retval;
END;
/

使用方式：

SELECT MD5('1') FROM dual;

實作方案三：企業級標準函數（含例外處理與大小寫控制）

CREATE OR REPLACE FUNCTION MD5HASH(str IN VARCHAR2) RETURN VARCHAR2 IS
  v_checksum VARCHAR2(32);
BEGIN
  v_checksum := LOWER(
                  RAWTOHEX(
                    UTL_RAW.CAST_TO_RAW(
                      SYS.DBMS_OBFUSCATION_TOOLKIT.MD5(input_string => str)
                    )
                  )
                );
  RETURN v_checksum;
EXCEPTION
  WHEN NO_DATA_FOUND THEN RETURN NULL;
  WHEN OTHERS THEN RAISE;
END MD5HASH;
/

進階應用：Java 端協同處理策略

-- Oracle 端建立函數（回傳大寫）
CREATE OR REPLACE FUNCTION MD5(vin_string IN VARCHAR2) RETURN VARCHAR2 IS
BEGIN
  RETURN UPPER(
           DBMS_OBFUSCATION_TOOLKIT.MD5(
             input => UTL_RAW.CAST_TO_RAW(vin_string)
           )
         );
END MD5;
/

最佳實踐原則：

• 資料庫僅儲存 MD5 密文，驗證時比對密文一致性
• 絕不實作解密功能，MD5 為單向雜湊，解密違背安全設計
• Java 端使用相同演算法產生密文傳輸，資料庫端直接比對
• 批次更新既有明文密碼：UPDATE users SET password = MD5(password);

常見誤區提醒

1. 直接在 SELECT 中呼叫原生套件：會報 ORA-06553 錯誤，必須包裝成函數
2. 忽略 RAW 型別轉換：導致顯示亂碼或比對失敗
3. 嵌套呼叫未逐層轉換：多層 MD5 運算結果錯誤
4. 大小寫不一致：資料庫與應用端編碼格式需統一（建議統一大寫或小寫）