您现在的位置：程式碼之家 >> 數據庫知識 > >> MySQL 資料庫 >> MySQL 綜合教學

MySQL 主備庫字符集不一致導致數據校驗失敗：根因分析、連接字符集統一策略與三種場景實測

編輯：MySQL 綜合教學

問題現場

主庫： `utf8` (或 `utf8mb4`)
備庫： `gbk`
校驗邏輯： 主庫連接 `SET NAMES utf8`，備庫連接 `SET NAMES gbk`，逐行逐字段 `strcasecmp` 比較。
現象： 明明相同漢字，校驗判定不一致。

根因剖析

字符集 ≠ 編碼。同一個漢字「中」：

UTF-8 編碼：`E4 B8 AD` (3 字節)
GBK 編碼：`D6 D0` (2 字節)

校驗程序直接比較**二進制字節序列**，編碼不同必然不相等。這不是數據不一致，是**表達形式不一致**。

解決方案：統一連接字符集

核心原則： 應用程序建立連接時，**主備庫使用相同的連接字符集**（`SET NAMES charset`），與服務器端存儲字符集無關。

三種連接字符集選擇策略

策略	連接字符集	適用條件	副作用
跟隨主庫	utf8 / utf8mb4	主庫為權威源、應用層以 UTF-8 為標準	備庫 gbk 存儲需隱式轉換，極少數字符可能無法表示 (如 Emoji)
跟隨備庫	gbk	歷史系統全鏈路 GBK、無 Emoji 需求	主庫 utf8mb4 數據含 4 字節字符時會報錯或截斷
統一為 utf8mb4 (推薦)	utf8mb4	新系統、需完整 Unicode 支持	備庫需 `ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4` 遷移

實戰驗證代碼 (PHP/PDO)

$dsnMaster = "mysql:host=master;dbname=test;charset=utf8mb4";
$dsnSlave  = "mysql:host=slave;dbname=test;charset=utf8mb4"; // 統一!

$pdoM = new PDO($dsnMaster, 'user', 'pass');
$pdoS = new PDO($dsnSlave, 'user', 'pass');

$stmtM = $pdoM->query("SELECT col FROM tbl WHERE id=1");
$stmtS = $pdoS->query("SELECT col FROM tbl WHERE id=1");

$valM = $stmtM->fetchColumn();
$valS = $stmtS->fetchColumn();

// 此時二進制字節序列一致，直接比較即可
var_dump($valM === $valS); // true

客戶端顯示亂碼？

連接字符集 ≠ 客戶端顯示字符集。終端/IDE/瀏覽器需設置為 UTF-8 顯示。若連接用 `utf8mb4` 但終端是 GBK，會看到亂碼，**但數據庫層面已正確**。

最佳實踐清單

**新系統統一 `utf8mb4`** (庫、表、列、連接、應用、前端)。
**遷移舊系統**：`ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci` (鎖表，大表用 `pt-online-schema-change`)。
**連接池配置**：`initSQL: "SET NAMES utf8mb4"` 確保每次獲取連接自動設置。
**校驗工具**：使用 `pt-table-checksum` (基於 checksum，不受編碼影響) 替代逐行比較。