MySQL 亂碼本質是編碼與解碼字元集不匹配。資料在「寫入 → 儲存 → 讀取 → 顯示」四個階段,任何一環字元集設定不一致,就會產生亂碼。本文提供系統性排查與配置清單。
應用程式 (client_charset)
↓ 連線字元集 (connection_charset)
MySQL Server (character_set_server)
↓ 資料庫字元集 (character_set_database)
資料表字元集 (character_set_table)
↓ 欄位字元集 (character_set_column)
儲存引擎實際編碼
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4'
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
重啟 MySQL 服務生效。utf8mb4 支援完整 Unicode (含 Emoji),強烈建議替代舊版 utf8。
CREATE DATABASE mydb
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
修改既有資料庫:ALTER DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(50)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
修改既有表:ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; (會轉換現有資料)
ALTER TABLE users MODIFY name VARCHAR(50)
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
檢查現有欄位字元集:SHOW FULL COLUMNS FROM users; 觀察 Collation 欄位。
PHP (PDO):
$pdo = new PDO("mysql:host=localhost;dbname=mydb;charset=utf8mb4", $user, $pass);
$pdo->exec("SET NAMES utf8mb4");
PHP (mysqli):
$mysqli->set_charset("utf8mb4");
Java (JDBC URL):
jdbc:mysql://localhost:3306/mydb?characterEncoding=utf8mb4&useUnicode=true&serverTimezone=Asia/Taipei
Python (PyMySQL):
conn = pymysql.connect(host='localhost', user='root', password='pass',
db='mydb', charset='utf8mb4')
Node.js (mysql2):
const pool = mysql.createPool({
host: 'localhost',
user: 'root',
password: 'pass',
database: 'mydb',
charset: 'utf8mb4'
});
| 現象 | 可能原因 | 解決方向 |
|---|---|---|
| 中文變 ??? 或 | 資料以 utf8 寫入,但欄位為 latin1 | ALTER TABLE ... CONVERT TO CHARSET utf8mb4 |
| 中文變 亂碼 (如 涓婂竷) | UTF-8 資料被 Latin1 讀取 (雙重編碼) | 檢查連線字元集 SET NAMES utf8mb4 |
| Emoji 存成 ???? | 使用 utf8 (僅 3 字節) 而非 utf8mb4 (4 字節) | 全鏈路升級 utf8mb4 |
| 排序錯誤 (拼音/筆畫) | Collation 不符預期 | 指定 utf8mb4_unicode_ci (UCA 標準) 或 _zh_ci |
SHOW VARIABLES LIKE 'character_set_%';
SHOW VARIABLES LIKE 'collation_%';
SELECT @@character_set_database, @@collation_database;
SHOW CREATE TABLE your_table;
SHOW FULL COLUMNS FROM your_table;
若資料已為「UTF-8 被 Latin1 讀取」的雙重編碼:
UPDATE `table` SET `column` = CONVERT(CAST(CONVERT(`column` USING latin1) AS BINARY) USING utf8mb4)
WHERE `column` IS NOT NULL;
務必先備份,小範圍測試驗證後再全量執行。
徹底搞定字元集配置,MySQL 亂碼問題將成為歷史。