萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 中 pageEncoding 與 contentType 屬性的差異深度解析

核心差異一覽

屬性作用階段影響對象預設值
pageEncoding JSP 編譯階段(翻譯為 Servlet) JSP 原始檔讀取、Java 原始碼產生 ISO-8859-1
contentType(含 charset) 執行階段(回應輸出) HTTP Response 標頭、瀏覽器解碼 text/html;charset=ISO-8859-1

三階段編碼流程詳解

  1. 階段一:JSP → .java(編譯期)
    容器依據 pageEncoding 讀取 JSP 檔案,將中文轉為 Unicode 產生 .java 原始碼。若 pageEncoding 錯誤或未設定,產生的 Java 原始碼即為亂碼,後續無法修復。
  2. 階段二:.java → .class(Java 編譯期)
    javac 以 UTF-8 讀取 Java 原始碼,編譯為位元組碼。此階段固定使用 UTF-8,不受 JSP 設定影響。
  3. 階段三:執行期輸出 HTML(執行期)
    容器執行 Servlet,產生輸出位元組流,依據 contentType 的 charset 編碼回傳瀏覽器。瀏覽器據此解碼顯示。

實測驗證

錯誤範例:僅設 contentType

<%@ 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 輸出 → 瀏覽器正常顯示。

特殊情況:pageEncoding ≠ contentType

適用於「JSP 檔案編碼與輸出編碼不同」的舊系統遷移:

<%@ page pageEncoding="GBK" contentType="text/html;charset=UTF-8" %>
  • JSP 檔案以 GBK 儲存(舊專案歷史)。
  • 輸出給瀏覽器用 UTF-8(現代標準)。
  • 容器自動轉碼:GBK → Unicode (Java) → UTF-8 (輸出)。

關鍵提醒

  • pageEncoding 決定「怎麼讀懂你的原始碼」,contentType 決定「怎麼吐給瀏覽器」。
  • Tomcat 4.1+:若只設定其中一個,另一個會自動跟隨(但不建議依賴此行為)。
  • .java 檔案編譯時預編碼為系統 locale(GBK/Big5),但 JSP 無此機制,必須顯式指定 pageEncoding。
  • 最佳實踐:專案統一 UTF-8,所有 JSP 頁面頂部固定 <%@ page pageEncoding="UTF-8" contentType="text/html;charset=UTF-8" %>。
copyright © 萬盛學電腦網 all rights reserved