Java 透過 JDBC 存取 MySQL 時中文變亂碼,幾乎每個人都遇過。問題可能出在任何一個環節:伺服器設定、資料庫與資料表編碼、連線字串、頁面宣告,甚至請求編碼。以下依可能性由基礎到進階整理排查順序。
先確認 my.ini 中三個區段都指定了 UTF-8:
[mysql] default-character-set=utf8 [client] default-character-set=utf8 [mysqld] default-character-set=utf8
接著在建表時明確指定字元集,不要依賴預設值:
DROP TABLE IF EXISTS `Company`; CREATE TABLE IF NOT EXISTS `Company` ( `Cname` VARCHAR(10) NOT NULL, `Caddr` VARCHAR(100), `Ctel` VARCHAR(16) ) ENGINE=InnoDB DEFAULT CHARSET=UTF8;
登入 MySQL 後可用 SHOW VARIABLES LIKE 'char%'; 檢查各項是否一致;若既有資料表編碼錯誤,需用 ALTER TABLE ... CONVERT TO CHARACTER SET utf8 轉換。
這是最直接有效的一招,無論讀取或寫入都會沿用連線設定的編碼:
// 載入 mysql-jdbc 驅動
Class.forName("com.mysql.jdbc.Driver").newInstance();
// 連線時指定編碼
Connection sqlCon = DriverManager.getConnection(
"jdbc:mysql://localhost:3306/test?user=root&password=1"
+ "&useUnicode=true&characterEncoding=utf-8");
若前三步都做完仍有問題,可在方法一的基礎上把字串從 ISO-8859-1 強制轉為 UTF-8:
String name = request.getParameter("name");
name = new String(name.getBytes("ISO-8859-1"), "utf-8");
從資料庫讀出來時也是同樣思路:
String name = new String(rst.getString("name").getBytes("ISO-8859-1"), "utf-8");
頁面本身的編碼宣告也要一致,否則伺服器端正確、輸出卻錯:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
若專案使用 GB2312,則改為 contentType="text/html;charset=gb2312"。重點是「檔案實際編碼、pageEncoding、contentType」三者必須互相吻合。
在 web.xml 中註冊一個編碼 Filter,讓所有請求進入前先完成轉碼,可省下在每個 Action 裡手動轉換的麻煩:
<filter>
<filter-name>UTFEncoding</filter-name>
<filter-class>com.founder.chenph.Util.EncodingFilter_UTF8</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>UTFEncoding</filter-name>
<url-pattern>*.jsp</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>UTFEncoding</filter-name>
<url-pattern>*.do</url-pattern>
</filter-mapping>
以上範例引用的是自建的 EncodingFilter_UTF8;實務上更常用 Spring 的 CharacterEncodingFilter 或直接設定 Connector 的 useBodyEncodingForURI="true"。
亂碼的本質是「編碼鏈條上有一個環節不一致」。建議依序檢查:MySQL 伺服器與表編碼 → JDBC 連線字串 → JSP pageEncoding 與 contentType → 請求編碼(Filter 或 Connector 設定)。其中方法二(連線字串)覆蓋率最高,通常加上之後問題就解決了;若仍不行,再往方法三、方法五逐一驗證。