Java EE 與 PHP 專案亂碼終極解決方案：全鏈路編碼一致性指南

亂碼根因：編碼鏈路任一環節不一致

瀏覽器 → Web 服務器 → 應用代碼 → 數據庫，任一節點編碼不匹配即產生亂碼。統一建議：全鏈路 UTF-8，國際化首選，避免 GBK/GB2312 兼容性陷阱。

Java EE 專案全鏈路配置清單

1. 前端頁面編碼

• HTML/JSP 頁頭： <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
• JSP 頁指令 (首行)： <%@ page contentType="text/html; charset=UTF-8" %>
• 文件保存編碼： IDE 設置為 UTF-8 (無 BOM)。

2. Web 服務器/容器層

最佳實踐： URL 參數避免中文，採用字典映射或 POST 表單傳遞。

3. Java 代碼層 (Servlet/Filter)

// 請求編碼 (必須在讀取參數前調用)
request.setCharacterEncoding("UTF-8");

// 響應編碼
response.setContentType("text/html; charset=UTF-8");
response.setCharacterEncoding("UTF-8");

推薦配置 CharacterEncodingFilter (Spring CharacterEncodingFilter / 手寫 Filter) 映射 /*，強制全局請求/響應 UTF-8，徹底解決表單提交亂碼。

4. 數據庫連接層

• MySQL JDBC URL： jdbc:mysql://host:3306/db?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull
• Oracle/PostgreSQL/SQL Server： 驅動通常自動協商，確保數據庫/表/列字符集為 UTF-8 (MySQL: utf8mb4, Oracle: AL32UTF8)。

5. 歷史遺留 MySQL 亂碼修復 (MySQL 4.1+)

• VARCHAR/CHAR：改為 BINARY 屬性或 ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4。
• TEXT/BLOB：需應用層轉碼工具類。

public class EncodingUtil {
    public static String isoToUtf8(String iso) {
        if (iso == null || iso.isEmpty()) return "";
        try {
            return new String(iso.getBytes("ISO-8859-1"), "UTF-8");
        } catch (Exception e) {
            throw new RuntimeException("編碼轉換失敗", e);
        }
    }
}

PHP 專案全鏈路配置清單

1. 頁面輸出編碼 (雙重保險)

• HTML Meta：<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
• PHP Header (腳本最開頭，輸出前)：header("Content-Type: text/html; charset=UTF-8");

2. 數據庫連接編碼 (關鍵)

$conn = mysqli_connect(host, user, pass, db);
mysqli_set_charset($conn, "utf8"); // 或 mysqli_query($conn, "SET NAMES 'utf8'");

PDO 方式：new PDO("mysql:host=...;dbname=...;charset=utf8", user, pass);

3. 文件保存編碼

IDE/編輯器保存為 UTF-8 (無 BOM)，避免 BOM 導致 header() 失效或輸出異常。

Java EE 典型亂碼場景速查表

總結：三大鐵律

1. 統一字符集： 全鏈路 UTF-8 (MySQL 用 utf8mb4 支援 Emoji)。
2. 早期設置： Filter/頁面指令/Header 必須在任何 I/O 操作前執行。
3. 文件無 BOM： 避免隱形字符破壞協議頭與輸出流。

遵循三大鐵律，亂碼問題將成為歷史。