萬盛學電腦網

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

CentOS 7 修改 MySQL 5.6 字符集為 UTF-8 徹底解決中文亂碼

問題背景

MySQL 5.6 預設字符集為 latin1,存儲中文時易出現「問號」或亂碼。生產環境必須統一將客戶端、連接層、服務端、結果集、數據庫、表、列全部設為 utf8mb4(支援 Emoji)或 utf8(僅 BMP 字符)。本文以 CentOS 7 + MySQL 5.6 為例,演示完整修改流程並驗證生效。

一、現狀排查

mysql -uroot -p
mysql> STATUS;
-- 觀察以下四項若非 utf8 則需修改
-- Charset: latin1
-- Conn: latin1
-- Database: latin1
-- Server: latin1

二、修改配置文件 /etc/my.cnf

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
init_connect='SET NAMES utf8mb4'
skip-character-set-client-handshake  -- 強制忽略客戶端指定字符集

說明:
• character-set-server 決定新建庫/表的預設字符集
• collation-server 決定預設排序規則
• init_connect 針對非超級用戶自動執行 SET NAMES
• skip-character-set-client-handshake 防止客戶端發送非 utf8 字符集導致不一致

三、重啟並驗證

systemctl restart mysqld
mysql -uroot -p
mysql> STATUS;
-- 應顯示:
-- Charset: utf8mb4
-- Conn: utf8mb4
-- Database: utf8mb4
-- Server: utf8mb4

四、存量數據轉換(關鍵步驟)

配置修改僅影響新建對象,現有庫/表/列仍為 latin1,需手動轉換:

1. 庫級轉換

ALTER DATABASE `shop` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci;

2. 表級轉換(含列)

ALTER TABLE `orders` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-- CONVERT TO 會同時轉換表默認字符集及所有字符類型列

3. 僅修改表默認字符集(不轉換現有列)

ALTER TABLE `orders` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci;

4. 單列轉換

ALTER TABLE `orders` MODIFY `remark` VARCHAR(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

五、應用層配置檢查

框架/驅動關鍵配置
JDBCurl 參數 characterEncoding=utf8mb4&useUnicode=true&zeroDateTimeBehavior=convertToNull
Python (PyMySQL)charset='utf8mb4'
PHP (PDO)charset=utf8mb4 在 DSN 中
Go (go-sql-driver/mysql)DSN charset=utf8mb4,utf8

六、字符集參數詳解

  • character_set_client:客戶端發送語句的字符集
  • character_set_connection:Server 將接收到的語句轉換為此字符集
  • character_set_database:當前默認數據庫字符集
  • character_set_results:結果集返回給客戶端的字符集
  • character_set_server:服務端安裝時的默認字符集
  • character_set_system:系統元數據字符集,固定 utf8

七、常見坑點

  1. utf8 vs utf8mb4:MySQL 的 utf8 僅支援 3 字節字符(BMP),無法存 Emoji;生產環境強烈建議 utf8mb4
  2. 排序規則:utf8mb4_general_ci 速度快但排序不準確(如 ß = ss);utf8mb4_unicode_ci 準確但稍慢,推薦 utf8mb4_0900_ai_ci (8.0+)
  3. 列長度限制:utf8mb4 每字符 4 字節,VARCHAR(255) 佔 1020 字節,InnoDB 單行上限約 8KB,聯合索引前綴長度總和不超 3072 字節(或啟用 innodb_large_prefix=ON)
  4. mysqldump 導出:加參數 --default-character-set=utf8mb4 避免導出文件編碼錯誤

八、總結

「配置文件改預設 + 存量對象 CONVERT TO + 應用層指定 utf8mb4」三步走,徹底根治中文亂碼。建議新項目直接採用 MySQL 8.0 + utf8mb4_0900_ai_ci,一勞永逸。

copyright © 萬盛學電腦網 all rights reserved