MySQL 亂碼本質是「編碼不一致」:Client、Connection、Server、Database、Table、Column 六層編碼任意一層不匹配即產生亂碼。本文提供「全鏈路顯式指定」統一策略,並詳細說明 utf8mb4 遷移的客戶端適配細節。
SHOW VARIABLES LIKE 'character_set_%';
SHOW VARIABLES LIKE 'collation_%';
關鍵變量:
| 變量 | 含義 | 建議值 |
|---|---|---|
| character_set_server | 服務端預設編碼 | utf8mb4 |
| character_set_database | 當前庫編碼 | utf8mb4 |
| character_set_client | 客戶端發送編碼 | utf8mb4 |
| character_set_connection | 連接層轉換編碼 | utf8mb4 |
| character_set_results | 結果集返回編碼 | utf8mb4 |
| collation_connection | 連接層排序規則 | utf8mb4_unicode_ci |
| 客戶端 | 配置方式 | 注意事項 |
|---|---|---|
| JDBC (Connector/J) | jdbc:mysql://host:3306/db?characterEncoding=utf8mb4 | 5.1.30+ 自動識別 server 端 utf8mb4,無需顯式指定 |
| Python MySQLdb | MySQLdb.connect(charset='utf8mb4') | 預設 latin1,必須顯式指定 |
| PHP PDO | new PDO("mysql:host=...;dbname=...;charset=utf8mb4", ...) | PHP 5.3.6+ 支援 DSN charset 參數 |
| PHP mysqli | $mysqli->set_charset('utf8mb4') | 連線後立即執行 |
| Go sqlx | db, _ = sqlx.Open("mysql", "user:pass@tcp(host:3306)/db?charset=utf8mb4") | go-sql-driver/mysql 1.4+ 支援 |
| 通用回退 | 連線後執行 SET NAMES utf8mb4 | 所有驅動通用,性能微損 |
utf8 = utf8mb3,僅支援 BMP (U+0000~U+FFFF)utf8mb4 是 utf8 的超集,完全向下兼容INSERT INTO t(c) VALUES ('😀') → HEX(c) = F09F9880 (4 字節)Connector/J did not support utf8mb4 for servers 5.5.2 and newer. Connector/J now auto-detects servers configured with character_set_server=utf8mb4 or treats the Java encoding utf-8 passed using characterEncoding=... as utf8mb4 in the SET NAMES= calls it makes when establishing the connection. (Bug #54175)
現代 JDBC 驅動(5.1.30+)已智能處理:檢測到 Server 端 character_set_server=utf8mb4 時,自動將 characterEncoding=utf-8 映射為 SET NAMES utf8mb4。
#!/bin/bash
# 檢查庫/表/列編碼一致性
mysql -uroot -p -e "
SELECT TABLE_SCHEMA, TABLE_NAME, TABLE_COLLATION
FROM information_schema.TABLES
WHERE TABLE_SCHEMA NOT IN ('mysql','information_schema','performance_schema','sys')
AND TABLE_COLLATION NOT LIKE 'utf8mb4%';
"
# 輸出非 utf8mb4 表,逐個遷移
character-set-server=utf8mb4 為準亂碼不是玄學,是編碼鏈路某環斷裂。建立「utf8mb4 全棧」標準,從 my.cnf 到連接池配置,從建表 DDL 到 ORM 映射,一次配置,永久免疫。