| 變量 | 含義 | 典型值 |
| character_set_server | 服務端默認內部操作字符集 | utf8mb4 |
| character_set_database | 當前庫默認字符集 | utf8mb4 |
| character_set_client | 客戶端發送數據編碼 | utf8mb4 |
| character_set_connection | 連接層轉換目標編碼 | utf8mb4 |
| character_set_results | 結果集返回編碼 | utf8mb4 |
| character_set_system | 系統元數據編碼(固定 utf8) | utf8 |
查看當前設置
SHOW VARIABLES LIKE 'character%';
SHOW VARIABLES LIKE 'collation%';
修改默認字符集(持久化)
配置文件 my.cnf / my.ini
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_general_ci
init_connect = 'SET NAMES utf8mb4'
init_connect = 'SET collation_connection = utf8mb4_general_ci'
重啟 MySQL 生效。
會話級臨時修改
SET NAMES utf8mb4; -- 等價於下面三句
SET character_set_client = utf8mb4;
SET character_set_results = utf8mb4;
SET character_set_connection = utf8mb4;
SET character_set_database = utf8mb4;
SET collation_database = utf8mb4_general_ci;
字符集轉換流程(關鍵!)
- 請求到達:
client → connection
- 內部操作:
connection → 列字符集 → 表默認 → 庫默認 → server(優先級遞減)
- 結果返回:
內部 → results
亂碼產生點:任一環節編碼不一致即產生轉換錯誤。
常見亂碼場景還原
| 場景 | 插入編碼 | 存儲編碼 | 查詢編碼 | 現象 |
| 未設置連接 | UTF-8 | latin1 | UTF-8 | 雙重編碼亂碼 (6 字節/漢字) |
| 連接 UTF-8,表 latin1 | UTF-8 | latin1 | UTF-8 | 超出 latin1 範圍字符變 ? |
| 全鏈路 UTF-8 | UTF-8 | UTF-8 | UTF-8 | 正常 |
排查工具函數
HEX(col) -- 查看實際存儲字節
CHAR_LENGTH(col) -- 字符數
LENGTH(col) -- 字節數
CHARSET(col) -- 列實際字符集
COLLATION(col) -- 列實際校對規則
Introducer 顯式指定字符串編碼
SELECT _utf8mb4 '中文' COLLATE utf8mb4_general_ci;
SELECT _latin1 'abc';
不經連接層轉換,直接按指定編碼進入內部處理。
最佳實踐總結
- 全鏈路 utf8mb4:庫、表、列、連接、應用框架配置
- 顯式創建指定字符集:
CREATE DATABASE ... CHARSET utf8mb4,不依賴默認值
- 連接建立即執行 SET NAMES:長連接/連接池需在
onConnect 回調中執行
- 避免裸字符串比較:
WHERE col = '值' 受連接字符集影響,必要時用 Introducer
- 升級檢查:MySQL 版本升級後驗證默認字符集未被重置
copyright ©
萬盛學電腦網 all rights reserved