萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> 資料庫綜合

MySQL 亂碼問題終極解決方案:從伺服器到應用層的完整字元集配置

MySQL 亂碼根治指南:字元集不一致的五大關鍵檢查點

MySQL 亂碼本質是編碼與解碼字元集不匹配。資料在「寫入 → 儲存 → 讀取 → 顯示」四個階段,任何一環字元集設定不一致,就會產生亂碼。本文提供系統性排查與配置清單。

字元集流向模型

應用程式 (client_charset) 
    ↓ 連線字元集 (connection_charset)
MySQL Server (character_set_server)
    ↓ 資料庫字元集 (character_set_database)
資料表字元集 (character_set_table)
    ↓ 欄位字元集 (character_set_column)
儲存引擎實際編碼

五大關鍵配置檢查點

1. 伺服器層級:my.cnf / my.ini 全域設定

[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。

2. 資料庫層級:建庫時显式指定

CREATE DATABASE mydb 
DEFAULT CHARACTER SET utf8mb4 
COLLATE utf8mb4_unicode_ci;

修改既有資料庫:ALTER DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 資料表層級:建表時显式指定

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; (會轉換現有資料)

4. 欄位層級:文字欄位显式指定

ALTER TABLE users MODIFY name VARCHAR(50) 
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

檢查現有欄位字元集:SHOW FULL COLUMNS FROM users; 觀察 Collation 欄位。

5. 連線層級:應用程式連線時設定 (最常被忽略)

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'
});

phpMyAdmin 介面設定 (圖形化工具)

  • 語言:Chinese Traditional (zh-utf-8) 或 Chinese Simplified (zh-utf-8)
  • MySQL 字元集:UTF-8 Unicode (utf8mb4)
  • MySQL 連線校對:utf8mb4_unicode_ci

常見亂碼場景診斷表

現象可能原因解決方向
中文變 ??? 或 資料以 utf8 寫入,但欄位為 latin1ALTER 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;

務必先備份,小範圍測試驗證後再全量執行。

總結:亂碼零發生的鐵律

  1. 伺服器、資料庫、資料表、欄位:**全鏈路 utf8mb4**
  2. 應用程式連線:**顯式 SET NAMES utf8mb4 / charset=utf8mb4**
  3. 新專案**從建庫開始**就鎖定 utf8mb4
  4. 定期執行驗證腳本巡檢

徹底搞定字元集配置,MySQL 亂碼問題將成為歷史。

copyright © 萬盛學電腦網 all rights reserved