MySQL 字符集配置實戰：my.cnf 三段式配置、會話動態修改、C API 設定、驗證指令全收錄

MySQL 字符集配置分為「伺服器持久化配置」、「會話級動態修改」、「C API 程式化設定」三大層面。本文提供 my.cnf 三段式標準配置、SHOW VARIABLES 驗證矩陣、SET 動態指令、C API mysql_options 呼叫範例，並說明預設 latin1 在特定場景下的「免配置相容性」。

一、持久化配置：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'

修改後 systemctl restart mysqld 生效。

二、驗證配置生效

SHOW VARIABLES LIKE 'character%';
+--------------------------+----------------------------+
| Variable_name            | Value                      |
+--------------------------+----------------------------+
| character_set_client     | utf8mb4                    |
| character_set_connection | utf8mb4                    |
| character_set_database   | utf8mb4                    |
| character_set_filesystem | binary                     |
| character_set_results    | utf8mb4                    |
| character_set_server     | utf8mb4                    |
| character_set_system     | utf8mb4                    |
| character_sets_dir       | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+

八項核心變數 (除 filesystem) 全為 utf8mb4 即為完全一致。

三、會話級動態修改 (無需重啟)

SET character_set_client = utf8mb4;
SET character_set_connection = utf8mb4;
SET character_set_database = utf8mb4;
SET character_set_results = utf8mb4;
SET character_set_server = utf8mb4;  -- 需 SUPER 權限，僅影響後續新連線

適用於無法修改配置文件的臨時環境 (如受管雲資料庫)。

四、C API 程式化設定

MYSQL *mysql = mysql_init(NULL);
mysql_options(mysql, MYSQL_SET_CHARSET_NAME, "utf8mb4");
mysql_real_connect(mysql, "host", "user", "pwd", "db", 3306, NULL, 0);

在 mysql_real_connect 前呼叫，確保連接建立即使用指定字符集。

五、關於預設 latin1 的特殊相容性

• 若應用、資料庫、連接**全鏈路均為 latin1**，中文 (GBK/Big5) 以位元組流透傳，**不會亂碼**也無需額外配置
• 但無法支援 Emoji、多語言混存、正確排序比較
• 現代應用**強烈建議**全鏈路遷移至 utf8mb4

六、版本差異提醒

總結

字符集配置「持久化 my.cnf 三段式 → 驗證 SHOW VARIABLES → 會話 SET 動態補救 → C API 程式化」四步走，覆蓋部署、運維、開發全場景。將驗證矩陣納入自動化部署腳本，新環境上線自動校驗，徹底告別亂碼。