DB2 代碼頁亂碼解決方案：三層級設定與建庫最佳實踐

DB2 中文亂碼核心成因在於三個層級的代碼頁設定不一致。本文系統梳理系統級、實例級、資料庫級三層代碼頁關係，提供從建庫到運行期的完整修正方案。

三層代碼頁架構

快速修正方案（新建資料庫）

直接建立中文相容資料庫：

-- 方式一：使用代碼頁數值 (1386=GBK, 86=中國區域)
db2 create db mydb using codeset 1386 territory 86

-- 方式二：使用標準名稱 (推薦)
db2 "CREATE DATABASE mydb USING CODESET UTF-8 TERRITORY CN"
-- 或
db2 "CREATE DATABASE mydb USING CODESET 1208 TERRITORY CN"

推薦 UTF-8 (1208)：支援完整 Unicode，避免 GBK 字元集不足問題。

既有資料庫亂碼排查步驟

步驟 1：確認資料庫實際 CODESET

db2 get db cfg for mydb | findstr /i codeset
# 或
db2 "SELECT CODESET FROM SYSCAT.DATABASES WHERE DB_NAME = 'MYDB'"

步驟 2：檢查實例級 DB2CODEPAGE

db2set -all | findstr DB2CODEPAGE
# 未設定則繼承 OS Locale

步驟 3：檢查 OS Locale

• Windows：控制台 → 區域 → 系統管理 → 系統區域設定
• Linux/Unix：locale 或 echo $LANG

步驟 4：對齊三層設定

原則：應用程式編碼 (DB2CODEPAGE) → 資料庫編碼 (CODESET) 需一致或可正確轉換。

• 資料庫為 UTF-8 (1208) → 設定 DB2CODEPAGE=1208 (UTF-8 用戶端) 或 1386 (GBK 用戶端，驅動自動轉換)
• 資料庫為 GBK (1386) → 設定 DB2CODEPAGE=1386

OS Locale 設定參考

# Linux/Unix 設為中文
export LANG=zh_CN.UTF-8
# 或永久修改 /etc/locale.conf

# Windows
# 控制台 → 區域 → 系統管理 → 更改系統區域設定 → 中文(簡體/繁體)

DB2CODEPAGE 設定指令

# 當前會話臨時生效
db2set DB2CODEPAGE=1386

# 實例級永久生效 (需重啟實例 db2stop/db2start)
db2set DB2CODEPAGE=1386 -i db2inst1

# 全域生效 (所有實例)
db2set DB2CODEPAGE=1386 -g

# 查看當前生效值
db2set -lr

常見代碼頁對照表

驗證修正成效

1. 重啟 DB2 實例：db2stop force && db2start
2. 連線測試：db2 connect to mydb user xxx using xxx
3. 插入中文：db2 "INSERT INTO t1 VALUES ('測試中文')"
4. 查詢驗證：db2 "SELECT * FROM t1" 觀察命令列顯示
5. 十六進制檢視：db2 "SELECT HEX(col1) FROM t1" 確認儲存編碼

避坑提醒

• 修改 DB2CODEPAGE 後必須重啟實例才生效
• 資料庫 CODESET 一旦建立永不可變，規劃時務必審慎
• 應用程式連線池可能緩存舊連線，修改後需重啟應用
• 跨平台遷移時，目標資料庫 CODESET 應與來源一致，或以 UTF-8 為統一標準