MySQL 字元集亂碼徹底解決：客戶端、連線、資料庫、表、欄位五層一致性原則

核心原則

**「寫入時的字元集 = 讀取時的字元集 = 儲存字元集」**
只要全鏈路一致，絕不亂碼。轉換發生在「客戶端字元集 ⇄ 資料庫字元集」之間，一致即免轉換、零損耗。

五層字元集設定

客戶端設定實戰

命令列

[mysql]
default-character-set=utf8mb4

JDBC

jdbc:mysql://host:3306/db?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=UTC

PHP PDO

$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", $user, $pass);
$pdo->exec("SET NAMES utf8mb4");

Python PyMySQL

conn = pymysql.connect(host='localhost', user='root', password='pass', db='test', charset='utf8mb4')

Go sqlx

db, _ = sqlx.Open("mysql", "user:pass@tcp(host:3306)/db?charset=utf8mb4&parseTime=True&loc=Local")

驗證指令

-- 1. 檢視所有字元集變數
SHOW VARIABLES LIKE 'character_set_%';
SHOW VARIABLES LIKE 'collation_%';

-- 2. 檢視資料庫
SHOW CREATE DATABASE db_name;

-- 3. 檢視資料表
SHOW TABLE STATUS FROM db_name LIKE 'tbl_name';
SHOW CREATE TABLE tbl_name;

-- 4. 檢視欄位
SHOW FULL COLUMNS FROM tbl_name;

-- 5. 支援字元集列表
SHOW CHARSET;

utf8 vs utf8mb4 必須知

• utf8（MySQL 別名 utf8mb3）：僅支援 BMP 平面（3 字節），不支援 Emoji、生僻漢字。
• utf8mb4：完整 UTF-8（4 字節），支援所有 Unicode 字符。**全面採用 utf8mb4**。

遷移舊庫至 utf8mb4

-- 1. 資料庫
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

-- 2. 所有表（需逐表執行）
ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- CONVERT TO 會轉換資料，單純 CHARSET= 只改預設

-- 3. 修改連線配置
-- 4. 重啟應用驗證

排序規則選擇

• utf8mb4_unicode_ci：標準 Unicode 排序，準確支援多語言（推薦）。
• utf8mb4_general_ci：舊版簡化排序，效能略高但不準確（如 ß=ss）。
• utf8mb4_bin：二進位比較，區分大小寫、口音，用於精確匹配/索引。

常見亂碼場景速查

建立「全鏈路 utf8mb4」標準，從架構層面根治亂碼顽疾。