MySQL 採分層字元集機制,優先級由低到高:
character_set_server — 伺服器預設character_set_database — 資料庫層級 (建庫時可覆蓋)character_set_table — 資料表層級 (建表時可覆蓋)character_set_client — 客戶端發送編碼character_set_connection — 連接層轉碼目標character_set_results — 結果集返回編碼核心原則:全鏈路統一編碼。最簡單做法:僅設定
character_set_server = utf8mb4,建庫建表不指定字元集,連接層執行SET NAMES utf8mb4。
| 編碼 | 中文位元組 | 英文位元組 | 適用場景 |
|---|---|---|---|
| UTF-8 / utf8mb4 | 3-4 bytes | 1 byte | 國際化、Emoji、多語言 |
| GBK | 2 bytes | 2 bytes | 純中文、舊系統相容 |
| GB2312 | 2 bytes | 2 bytes | GBK 子集,簡體中文 |
| BIG5 | 2 bytes | 2 bytes | 繁體中文 |
| Latin1 | 1 byte (亂碼) | 1 byte | 二進制透傳、不建議中文 |
SHOW VARIABLES LIKE '%char%';client/connection/database 不一致results/connection/client 不一致-- 連接後立即執行 (等價於 SET NAMES)
SET character_set_client = utf8mb4;
SET character_set_connection = utf8mb4;
SET character_set_results = utf8mb4;
$mysqli->set_charset('utf8mb4');
// PDO
$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", $user, $pass);
jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
<Connector port="8080" URIEncoding="UTF-8" />
// web.xml
<filter>
<filter-name>EncodingFilter</filter-name>
<filter-class>com.example.EncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>EncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
| 誤區 | 後果 | 正確做法 |
|---|---|---|
| 僅設定資料庫/表字元集 | 連接層仍用 latin1,寫入時雙向轉碼產生亂碼 | 必須 SET NAMES 或驅動層指定 charset |
| 用 utf8 而非 utf8mb4 | 無法儲存 Emoji、生僻字 (需 4 bytes) | MySQL 5.5.3+ 全面改用 utf8mb4 |
| 備份檔編碼與匯入不符 | Unknown command、資料損壞 | mysqldump --default-character-set=utf8mb4 |
<?php
$link = mysqli_connect($host, $user, $pass, $db);
mysqli_set_charset($link, 'utf8mb4'); // 一行搞定所有連接層字元集
// 或 PDO
$pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8mb4", $user, $pass);
?>
配合 htmlspecialchars($str, ENT_QUOTES, 'UTF-8') 輸出,徹底告別亂碼。