| 屬性 | 作用階段 | 影響對象 | 預設值 |
|---|---|---|---|
pageEncoding |
JSP 編譯階段(翻譯為 Servlet) | JSP 原始檔讀取、Java 原始碼產生 | ISO-8859-1 |
contentType(含 charset) |
執行階段(回應輸出) | HTTP Response 標頭、瀏覽器解碼 | text/html;charset=ISO-8859-1 |
pageEncoding 讀取 JSP 檔案,將中文轉為 Unicode 產生 .java 原始碼。若 pageEncoding 錯誤或未設定,產生的 Java 原始碼即為亂碼,後續無法修復。
javac 以 UTF-8 讀取 Java 原始碼,編譯為位元組碼。此階段固定使用 UTF-8,不受 JSP 設定影響。contentType 的 charset 編碼回傳瀏覽器。瀏覽器據此解碼顯示。<%@ page contentType="text/html;charset=UTF-8" %>
<% out.print("你好"); %>
JSP 檔案以系統預設編碼(如 GBK/Big5)儲存,容器以 ISO-8859-1 讀取 → 產生錯誤 Java 原始碼 → 輸出亂碼。
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<% out.print("你好"); %>
容器以 UTF-8 讀取 JSP → 正確產生 Java 原始碼 → 以 UTF-8 輸出 → 瀏覽器正常顯示。
適用於「JSP 檔案編碼與輸出編碼不同」的舊系統遷移:
<%@ page pageEncoding="GBK" contentType="text/html;charset=UTF-8" %>
pageEncoding 決定「怎麼讀懂你的原始碼」,contentType 決定「怎麼吐給瀏覽器」。.java 檔案編譯時預編碼為系統 locale(GBK/Big5),但 JSP 無此機制,必須顯式指定 pageEncoding。<%@ page pageEncoding="UTF-8" contentType="text/html;charset=UTF-8" %>。