MySQL 預存程序異常處理機制詳解：DECLARE HANDLER 語法與實戰範例

HANDLER 語法結構

DECLARE handler_action HANDLER 
FOR condition_value [, condition_value] ... 
statement

handler_action 三種模式

• CONTINUE：執行 statement 後繼續執行後續程式碼（SQLWARNING/NOT FOUND 預設）。
• EXIT：執行 statement 後離開當前 BEGIN...END 區塊（SQLEXCEPTION 預設）。
• UNDO：回滾（目前 MySQL 暫不支援）。

condition_value 六大類型

自訂條件名稱

提升可讀性：

DECLARE foreign_key_error CONDITION FOR 1062;
DECLARE CONTINUE HANDLER FOR foreign_key_error 
    SET @msg = 'Foreign key violation';

實戰範例：處理重複鍵錯誤

CREATE PROCEDURE sp_add_location (
    IN in_location VARCHAR(30),
    IN in_address1 VARCHAR(30),
    IN in_address2 VARCHAR(30),
    IN zipcode VARCHAR(10),
    OUT out_status VARCHAR(30)
)
BEGIN
    DECLARE CONTINUE HANDLER FOR 1062 
        SET out_status = 'Duplicate Entry';
    
    SET out_status = 'OK';
    INSERT INTO locations (location, address1, address2, zipcode)
    VALUES (in_location, in_address1, in_address2, zipcode);
END;

預設行為補充

• 無 HANDLER 時：SQLWARNING/NOT FOUND → 忽略繼續；SQLEXCEPTION → 立即終止。
• 一個 HANDLER 可對應多個 condition_value，以逗號分隔。
• statement 可為單行或 BEGIN ... END 區塊。

最佳實踐建議

1. 優先使用 SQLSTATE 而非錯誤碼，跨版本相容性較佳。
2. 為常見業務錯誤定義 condition_name，程式碼自文檔化。
3. 謹慎使用 EXIT，確保資源釋放（關閉游標、釋放鎖）。
4. 記錄錯誤上下文（時間、參數、堆疊）便於事後排查。

1. 上一篇文章： MySQL 游標輸出資料實戰範例：逐行擷取員工 ID 列表
2. 下一篇文章： Windows 免安裝部署 MySQL 5.7 完整實戰記錄：初始化、註冊服務、Root 密碼重置

MySQL 綜合教學

MySQL Event 事件調度器：5.1 新特性定時任務實戰指南

什麼是 Event Scheduler？ MySQL 5.1

Windows MySQL 5.7 MSI 安裝配置圖文全流程指南

安裝包版本說明 文件名類型說明 mysql-install

JDBC 連接 MySQL 進階實戰（二）：DBUtility 封裝連接獲取與關閉

JDBC 連接 MySQL 進階實戰（二）：DBUtilit

JDBC 分頁查詢 MySQL 實戰：LIMIT 子句、PreparedStatement 參數化與總記錄數統計

JDBC 分頁查詢 MySQL 實戰：LIMIT 子句、Pr