萬盛學電腦網

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

MySQL 中文亂碼終極解決方案:全鏈路字元集統一實戰

一、 字元集層級與優先級

MySQL 採分層字元集機制,優先級由低到高:

  1. character_set_server — 伺服器預設
  2. character_set_database — 資料庫層級 (建庫時可覆蓋)
  3. character_set_table — 資料表層級 (建表時可覆蓋)
  4. character_set_client — 客戶端發送編碼
  5. character_set_connection — 連接層轉碼目標
  6. character_set_results — 結果集返回編碼

核心原則:全鏈路統一編碼。最簡單做法:僅設定 character_set_server = utf8mb4,建庫建表不指定字元集,連接層執行 SET NAMES utf8mb4。

二、 三大編碼對照表

編碼中文位元組英文位元組適用場景
UTF-8 / utf8mb43-4 bytes1 byte國際化、Emoji、多語言
GBK2 bytes2 bytes純中文、舊系統相容
GB23122 bytes2 bytesGBK 子集,簡體中文
BIG52 bytes2 bytes繁體中文
Latin11 byte (亂碼)1 byte二進制透傳、不建議中文

三、 亂碼診斷三步法

  1. 檢視系統變數:SHOW VARIABLES LIKE '%char%';
  2. 判斷亂碼發生點:
    • 寫入即亂碼 → client/connection/database 不一致
    • 讀出才亂碼 → results/connection/client 不一致
  3. 統一設定:
    -- 連接後立即執行 (等價於 SET NAMES)
    SET character_set_client = utf8mb4;
    SET character_set_connection = utf8mb4;
    SET character_set_results = utf8mb4;

四、 各語言/框架配置範本

PHP (mysqli/PDO)

$mysqli->set_charset('utf8mb4');
// PDO
$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", $user, $pass);

Java / JDBC

jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai

Tomcat (server.xml)

<Connector port="8080" URIEncoding="UTF-8" />

JSP / Servlet Filter 統一編碼

// 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>

my.cnf / my.ini 伺服器端固化

[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 專屬終極方案

<?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') 輸出,徹底告別亂碼。

copyright © 萬盛學電腦網 all rights reserved