XAMPP 環境下 MySQL 字符集修改實戰：避坑指南與最佳配置

問題現場還原

安裝 XAMPP 後未提示字符集配置，執行 SHOW VARIABLES LIKE '%char%' 發現：

• character_set_server = latin1（服務端預設）
• character_set_database = utf8（庫級預設）
• 客戶端/連線/結果集多為 utf8mb4

直接在 my.ini 新增 character_set_client=utf8mb4 導致 MySQL 重啟失敗。

根因分析

1. 參數作用域錯誤：character_set_client 是會話級系統變數，不可寫入配置檔作為全域預設。
2. 配置節點缺失：需在 [mysqld] 區塊設定 character_set_server、collation_server；[client] 區塊設定 default-character-set。
3. 編碼版本混淆：MySQL 5.5.3+ 推薦 utf8mb4（支援 4 字節 Emoji），舊 utf8 實為 utf8mb3。

正確配置範本（my.ini 關鍵段）

[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

[mysqld]
character_set_server = utf8mb4
collation_server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4'
skip_character_set_client_handshake = ON
# character_sets_dir 保持預設即可，除非自定義字符集

關鍵參數解讀

• skip_character_set_client_handshake：強制忽略客戶端發送的字符集，統一由伺服器指定，防止應用層未設字符集導致亂碼。
• init_connect：非超級用戶連線時自動執行 SET NAMES utf8mb4，兼容舊驅動。
• 重啟驗證：修改後執行 mysqladmin -u root -p shutdown 再啟動，或用 XAMPP 控制面板重啟。

避坑檢查清單

1. 只在現有註釋行基礎上修改，勿隨意新增未知參數。
2. 區分 [mysqld]（服務端）與 [client]/[mysql]（客戶端）區塊。
3. 資料庫/表/欄位層級仍需顯式指定 CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci，配置檔僅影響新建對象預設值。
4. 應用層連線字串加入 characterEncoding=utf8mb4（JDBC）或 charset=utf8mb4（PHP PDO）。

驗證腳本

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';
-- 預期全為 utf8mb4 / utf8mb4_unicode_ci

總結：MySQL 字符集配置層級分明（Server/Database/Table/Column/Connection），以 my.ini 服務端區塊統一 Server/Database/Connection 三層預設為 utf8mb4 是穩健方案。切勿對會話級變數寫死配置檔。