萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

Oracle 亂碼問題根治:NLS_LANG、ORA_NLS10/33 環境變數完整配置指南 (含 9i/10g/11g/19c)

SQL*Plus 連線顯示 ???? 或亂碼,核心原因是伺服器端資料庫字元集與客戶端 NLS_LANG 字元集不一致。本文提供各版本、各平台的標準配置模板。

核心原則

客戶端 NLS_LANG 的字元集部分必須等於伺服器端 NLS_CHARACTERSET (或為其超集,如 UTF-8 客戶端連 GBK 伺服器通常可工作,但反向不可)。

常見伺服器字元集對應客戶端設定

平台別設定方式

Linux/Unix Shell

# csh/tcsh
setenv NLS_LANG AMERICAN_AMERICA.ZHS16GBK

# bash/sh/ksh/zsh
export NLS_LANG=AMERICAN_AMERICA.ZHS16GBK

# 永久生效:寫入 ~/.bash_profile 或 /etc/profile

Windows

  1. 註冊表:HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_{OracleHome}\NLS_LANG 修改字串值。
  2. CMD 臨時:SET NLS_LANG=AMERICAN_AMERICA.ZHS16GBK。
  3. PowerShell 永久:[Environment]::SetEnvironmentVariable('NLS_LANG','AMERICAN_AMERICA.ZHS16GBK','User')。

版本特定 NLS 資料目錄環境變數

伺服器字元集客戶端 NLS_LANG 範例 (語言_地域.字元集)
ZHS16GBK (簡體中文)AMERICAN_AMERICA.ZHS16GBK、SIMPLIFIED CHINESE_CHINA.ZHS16GBK
ZHT16BIG5 (繁體中文)TRADITIONAL CHINESE_TAIWAN.ZHT16BIG5
AL32UTF8 (Unicode)AMERICAN_AMERICA.AL32UTF8、ENGLISH_UNITED KINGDOM.AL32UTF8
JA16SJIS (日文)JAPANESE_JAPAN.JA16SJIS
KO16KSC5601 (韓文)KOREAN_KOREA.KO16KSC5601
WE8ISO8859P1 (西歐)AMERICAN_AMERICA.WE8ISO8859P1
# 10g+ 範例
export ORA_NLS10=$ORACLE_HOME/nls/data
# 9i 範例
export ORA_NLS33=$ORACLE_HOME/ocommon/nls/data

缺少此變數會導致 NLS_CHARACTERSET 查詢失敗、字元集轉換函數報錯 ORA-12705。

JDBC Thin 驅動特殊說明

  • JDBC Thin 不讀取 NLS_LANG,字元轉換由 JVM file.encoding 與驅動內部映射表決定。
  • 確保啟動參數:-Dfile.encoding=UTF-8 (或目標編碼)。
  • 12.2+ 驅動支援 oracle.jdbc.defaultNCharset 覆蓋 NCHAR/NVARCHAR2 編碼。

驗證腳本

-- 伺服器端
SELECT userenv('language'), value FROM nls_database_parameters WHERE parameter='NLS_CHARACTERSET';

-- 客戶端 (SQL*Plus)
SELECT * FROM nls_session_parameters WHERE parameter IN ('NLS_LANGUAGE','NLS_TERRITORY','NLS_CHARACTERSET');

-- 測試中文顯示
SELECT '測試中文' FROM dual;

統一配置 NLS_LANG 與版本對應的 ORA_NLSxx,即可徹底解決 99% 的 Oracle 亂碼問題。

copyright © 萬盛學電腦網 all rights reserved
版本環境變數預設路徑
10g / 11g / 12c / 18c / 19cORA_NLS10$ORACLE_HOME/nls/data
9i / 9.2ORA_NLS33$ORACLE_HOME/ocommon/nls/data
8iORA_NLS32$ORACLE_HOME/ocommon/nls/data