SQL 預存程序錯誤處理最佳實踐：標準化返回碼與異常捕獲

前言：為何需要統一的錯誤處理規範

在多方協同開發中，預存程序若缺乏統一錯誤處理標準，極易導致應用層無法精準判斷執行狀態，造成聯調困難、問題定位耗時。本文詳細說明如何在 SQL 預存程序中建立健全的錯誤處理機制，確保返回碼語義清晰、異常流程可控。

核心原則

1. 返回系統原生 SQLCODE，而非自訂錯誤碼（如 79700），避免語義誤導。
2. 提供錯誤描述輸出參數（returnMsg），輔助快速定位問題。
3. 善用 Handler 機制：區分 NOT FOUND、SQLEXCEPTION 等情境，精細控制流程走向。

標準範本：OUT_LANGUAGE 程序結構

CREATE PROCEDURE OUT_LANGUAGE (
  ...,
  OUT returnCode INTEGER,
  OUT returnMsg  CHAR(32)
)
SPECIFIC SQL_OUT_LANGUAGE
LANGUAGE SQL
BEGIN
  DECLARE SQLCODE INTEGER DEFAULT 0;
  DECLARE SQLSTATE CHAR(5) DEFAULT '00000';
  DECLARE errorLabel CHAR(32) DEFAULT '';

  -- 1. 忽略 NOT FOUND，繼續執行
  DECLARE CONTINUE HANDLER FOR NOT FOUND
  BEGIN
    SET returnCode = SQLCODE;  -- 或 SET returnCode = 0; 視業務需求
  END;

  -- 2. 遇到 SQL 異常，立即跳出並記錄錯誤
  DECLARE EXIT HANDLER FOR SQLEXCEPTION
  BEGIN
    SET returnCode = SQLCODE;
    SET returnMsg  = errorLabel;
  END;

  -- 業務邏輯區塊
  ......

  -- 3. 進階：條件性忽略特定錯誤碼（如 -454 物件已存在/唯一鍵衝突）
  DECLARE CONTINUE HANDLER FOR SQLEXCEPTION
  BEGIN
    IF (SQLCODE = -454) THEN
      SET returnCode = 0;  -- 視為成功繼續
    ELSE
      SET returnCode = SQLCODE;
      SET returnMsg  = errorLabel;
    END IF;
  END;

  -- 後續流程依 returnCode 判斷
  IF (returnCode = 0) THEN ...... END IF;
  IF (returnCode = 0) THEN ...... END IF;
END

關鍵點解析

避坑提醒

• 禁用自訂魔術數字：如 79700 等非標準碼，極易誤導聯調人員誤判為 DB2 文件定義錯誤。
• 錯誤語境保留：errorLabel 應在關鍵操作前賦值（如 'INSERT_USERS'），異常時可知發生位置。
• 統一規範落地：團隊需制定《預存程序錯誤處理規範》，Code Review 時強制檢查。

總結

標準化的錯誤處理不僅能讓應用層「看得懂」執行結果，更能在故障發生時縮短 80% 以上的定位時間。請將此範本納入專案開發規範，從源頭杜絕「狀態不明」的聯調惡夢。