MySQL 涉及四層字符集轉換,任一環節不匹配即產生亂碼:
查看當前會話所有字符集變量:
SHOW VARIABLES LIKE 'character_set_%';
SHOW VARIABLES LIKE 'collation_%';
/etc/my.cnf 或 /etc/mysql/my.cnf[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4' # 非超級用戶連接時自動執行
skip-character-set-client-handshake # 強制忽略客戶端聲明,統一用服務端設置
修改後重啟 MySQL:systemctl restart mysqld。
CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE t1 (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
| 語言/框架 | 正確連接參數 |
|---|---|
| JDBC (MySQL Connector/J 8.0+) | jdbc:mysql://host:3306/db?characterEncoding=utf8mb4&useSSL=false |
| PHP PDO | new PDO("mysql:host=host;dbname=db;charset=utf8mb4", $user, $pass) |
| PHP mysqli | $mysqli->set_charset("utf8mb4"); |
| Python PyMySQL | pymysql.connect(..., charset='utf8mb4') |
| Go (go-sql-driver/mysql) | user:pass@tcp(host:3306)/db?charset=utf8mb4,utf8 |
| Node.js (mysql2) | createConnection({charset: 'utf8mb4'}) |
SET NAMES驅動程序內部已處理字符集協商,手動執行 SET NAMES utf8mb4 可能導致驅動狀態與服務端不同步,引發更隱蔽的 Bug。
若老系統已大量使用 GBK(gbk_chinese_ci),無法立即全量遷移至 utf8mb4,可採用「雙軌制」:
character-set-server=gbk。charset=gbk(JDBC: characterEncoding=GBK)。CHARSET=utf8mb4,並在應用層對該表單獨建立 utf8mb4 連接池。ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;(會鎖表,大表用 pt-online-schema-change 或 gh-ost)。SELECT HEX(col), col FROM t WHERE id=1; 對照 Unicode 碼位。SHOW CREATE TABLE t\G。SHOW SESSION VARIABLES LIKE 'character_set_%';。utf8 實為 utf8mb3,僅支持 BMP 平面(3 字節),無法存儲 Emoji、生僻字。必須用 utf8mb4。SET NAMES 代替連接參數:驅動不知情,準備語句參數綁定可能出錯。utf8mb4_general_ci 與 utf8mb4_unicode_ci 在某些字符排序、比較上有差異,建議統一用 unicode_ci(或 0900_ai_ci)。字符集問題 90% 發生在「客戶端以為是 UTF-8,服務端以為是 Latin1/GBK」的協商失敗上。統一全鏈路顯式聲明 utf8mb4,是一次性徹底解決的關鍵。