萬盛學電腦網

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

MySQL 字元集亂碼避坑指南:執行腳本前必檢查字元集

慘痛教訓

新專案上線,執行開發提供的 SQL 腳本未確認字元集,導致頁面顯示亂碼。幸得領導頂缸,深刻警醒:執行任何 SQL 腳本前,務必先檢查字元集!

快速檢查命令

-- 客戶端、連線、結果集字元集
SHOW VARIABLES LIKE 'character_set_%';

-- 資料庫、表、欄位字元集
SHOW CREATE DATABASE db_name;
SHOW CREATE TABLE tbl_name;
SELECT COLUMN_NAME, CHARACTER_SET_NAME, COLLATION_NAME
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA='db_name' AND TABLE_NAME='tbl_name';

關鍵字元集變數

統一字元集最佳實踐

  1. 配置檔鎖定:my.cnf [mysqld] 區段設定 character-set-server=utf8mb4、collation-server=utf8mb4_general_ci。
  2. 連線指定:JDBC URL 加 characterEncoding=utf8mb4,或執行 SET NAMES utf8mb4。
  3. 建庫建表顯式指定:CREATE DATABASE ... CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
  4. 腳本檔案編碼:SQL 檔案儲存為 UTF-8 無 BOM。

排查清單

  • ☐ Server 字元集配置
  • ☐ 連線字元集設定
  • ☐ 資料庫/表/欄位字元集
  • ☐ SQL 檔案編碼
  • ☐ 應用框架字元集配置(Spring CharacterEncodingFilter 等)
copyright © 萬盛學電腦網 all rights reserved
變數作用建議值
character_set_client客戶端發送語句編碼utf8mb4
character_set_connection連線層轉碼目標utf8mb4
character_set_results結果集返回編碼utf8mb4
character_set_database預設資料庫字元集utf8mb4
character_set_serverServer 級預設utf8mb4