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,需手動轉換:
ALTER DATABASE `shop` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci;
ALTER TABLE `orders` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-- CONVERT TO 會同時轉換表默認字符集及所有字符類型列
ALTER TABLE `orders` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci;
ALTER TABLE `orders` MODIFY `remark` VARCHAR(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
| 框架/驅動 | 關鍵配置 |
|---|---|
| JDBC | url 參數 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:系統元數據字符集,固定 utf8utf8 僅支援 3 字節字符(BMP),無法存 Emoji;生產環境強烈建議 utf8mb4utf8mb4_general_ci 速度快但排序不準確(如 ß = ss);utf8mb4_unicode_ci 準確但稍慢,推薦 utf8mb4_0900_ai_ci (8.0+)VARCHAR(255) 佔 1020 字節,InnoDB 單行上限約 8KB,聯合索引前綴長度總和不超 3072 字節(或啟用 innodb_large_prefix=ON)--default-character-set=utf8mb4 避免導出文件編碼錯誤「配置文件改預設 + 存量對象 CONVERT TO + 應用層指定 utf8mb4」三步走,徹底根治中文亂碼。建議新項目直接採用 MySQL 8.0 + utf8mb4_0900_ai_ci,一勞永逸。