MySQL 中文數據插入亂碼問題排查筆記：腳本、MyBatis、JUnit 三大場景解決方案

場景一：SQL 腳本導入中文數據

1. 導入前執行：SET NAMES gbk 或 CHARSET gbk
2. 修改表字段字符集：ALTER TABLE 表名 MODIFY 列名 類型 CHARACTER SET gbk
3. 注意：控制台執行可能報錯，建議使用客戶端工具（Navicat、Workbench 等）執行

場景二：MyBatis XML Mapper 配置

確保 Mapper XML 正確引入配置，關鍵屬性：

<mapper namespace="...">
  <resultMap ...>...</resultMap>
  <select ...>...</select>
</mapper>

場景三：JUnit 測試讀取中文失敗

解決方案：JDBC 連接串添加字符編碼參數：

jdbc:mysql://localhost:3306/dbname?useUnicode=true&characterEncoding=utf8

或根據實際編碼調整為 gbk。

核心原則

• 全鏈路字符集一致：客戶端、連接、表字段、數據庫默認字符集
• 優先使用 UTF-8（utf8mb4）避免兼容性問題
• 腳本導入時顯式指定 SET NAMES