DIV CSS 佈局教程網

Java 連接 MySQL 出現中文亂碼的五種排查與解法
編輯:JavaScript綜合知識     

Java 透過 JDBC 存取 MySQL 時中文變亂碼,幾乎每個人都遇過。問題可能出在任何一個環節:伺服器設定、資料庫與資料表編碼、連線字串、頁面宣告,甚至請求編碼。以下依可能性由基礎到進階整理排查順序。

方法一:從 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");

方法四:JSP 頁面宣告

頁面本身的編碼宣告也要一致,否則伺服器端正確、輸出卻錯:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

若專案使用 GB2312,則改為 contentType="text/html;charset=gb2312"。重點是「檔案實際編碼、pageEncoding、contentType」三者必須互相吻合。

方法五:用 Filter 統一攔截請求編碼

在 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 設定)。其中方法二(連線字串)覆蓋率最高,通常加上之後問題就解決了;若仍不行,再往方法三、方法五逐一驗證。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved