PL/SQL Developer ORA-06502 字符串緩衝區太小錯誤解決方法

PL/SQL Developer ORA-06502 字符串緩衝區太小錯誤解決方法

錯誤現象

在 PL/SQL Developer 中執行 PL/SQL 程式塊或查詢大量文本資料時，彈出錯誤對話框：

ORA-06502: PL/SQL: numeric or value error: character string buffer too small

根因分析

PL/SQL Developer 內部為變數輸出、DBMS_OUTPUT 緩衝區、查詢結果顯示分配了固定大小的緩衝區。當實際資料長度超過預設緩衝區大小（通常為 32767 字節或更小）時觸發此錯誤。

解決方案：調整 PL/SQL Developer 緩衝區大小

1. 選單列點選 Tools → Preferences（或 工具 → 偏好設定）
2. 左側樹狀導航展開 PL/SQL 節點
3. 找到 Buffer Size 或 DBMS Output Buffer 設定項
4. 將預設值（如 10000、20000）調大，建議設為 1000000 (1MB) 或 2000000 (2MB)
5. 點選 OK 套用，重新執行程式碼

程式碼層面的補充防範

雖然調整工具設定可解決顯示問題，但生產環境 PL/SQL 代碼仍應做好防禦：

-- 1. 明確宣告足夠大小的變數
DECLARE
  v_large_text VARCHAR2(32767);  -- 最大 32767 位元組
  v_clob       CLOB;             -- 超過 32K 必須用 CLOB
BEGIN
  -- 處理邏輯
END;

-- 2. DBMS_OUTPUT 啟用足夠緩衝區
BEGIN
  DBMS_OUTPUT.ENABLE(1000000);  -- 設定 1MB 緩衝區
  -- 後續 DBMS_OUTPUT.PUT_LINE 才不會溢位
END;

-- 3. 字符串拼接注意長度檢查
v_result := v_result || v_new_part;
IF LENGTHB(v_result) > 32767 THEN
  -- 處理超長邏輯，如寫入 CLOB 或分段處理
END IF;

常見觸發場景