Oracle 中文長度陷阱：Java 與資料庫字元集差異導致的 VARCHAR2 定義與 LENGTH/LENGTHB 實測

Oracle 中文長度陷阱分析

Java String.length() 計算字元數 (中英皆為 1)，但 Oracle VARCHAR2 以位元組為單位，不同字元集中文佔用位元組數不同，導致插入時長度超限錯誤。

一、字元集與中文位元組數對照

二、查看目前字元集

SELECT * FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER='NLS_CHARACTERSET';

三、LENGTH vs LENGTHB 實測

SELECT LENGTH('測試') FROM DUAL;   -- 2 (字元數)
SELECT LENGTHB('測試') FROM DUAL;  -- 4 (位元組數，ZHS16GBK 環境)
SELECT LENGTH('cs') FROM DUAL;     -- 2
SELECT LENGTHB('cs') FROM DUAL;    -- 2

結論：定義 VARCHAR2 時需考慮字元集，VARCHAR2(n) 等同 VARCHAR2(n BYTE)。

四、應用層驗證建議

• Java 端驗證改用 string.getBytes(charset).length 計算位元組長度。
• 或在資料庫層用 LENGTHB 檢查並拋回錯誤。
• 統一使用 AL32UTF8 字元集可簡化多語系支援，但需預留 3 倍空間。