萬盛學電腦網

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

JSP 中文亂碼徹底解決方案:Eclipse 設定與頁面編碼完整指南

問題現象

JSP 頁面輸出中文顯示為「??」或亂碼,主要原因是**檔案編碼**、**頁面宣告編碼**、**伺服器預設編碼**三者不一致。

方案一:Eclipse 全域設定(針對新建檔案)

  1. 開啟 Window → Preferences
  2. 搜尋 JSP 或 Encoding
  3. 找到 Web → JSP Files → Encoding
  4. 將 ISO-8859-1 改為 UTF-8(推薦)或 GB18030
  5. 點擊 Apply and Close

此後新建 JSP 會自動在頁首加入:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

方案二:修正既有檔案編碼(逐檔處理)

對已存在的 JSP,需同步修改三處編碼宣告:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>中文測試</title>
</head>
<body>
    你好,世界!
</body></html>

關鍵點: pageEncoding 決定 JSP 檔案本身的儲存編碼;contentType 指定 HTTP 回應標頭;<meta> 供瀏覽器解析參考。三者**必須一致**。

方案三:Tomcat 全域強制 UTF-8(治本)

修改 conf/server.xml 的 Connector 節點:

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8"
           useBodyEncodingForURI="true" />

修改 conf/web.xml 新增過濾器(或使用 Spring 的 CharacterEncodingFilter):

<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>ignore</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

編碼選擇建議:UTF-8 vs GB18030

常見誤區

  • ❌ 僅修改 <meta> 標籤 → 無效,瀏覽器已依 HTTP Header 解碼
  • ❌ 混用 UTF-8 與 GBK → 必發生亂碼
  • ✅ 統一全專案、資料庫、前端、伺服器皆為 UTF-8

驗證清單

  1. JSP 檔案儲存編碼 = UTF-8
  2. page 指令 pageEncoding = UTF-8
  3. page 指令 contentType = text/html; charset=UTF-8
  4. HTML meta charset = UTF-8
  5. Tomcat URIEncoding = UTF-8
  6. 資料庫連線字串含 characterEncoding=utf8
  7. Java 原始碼檔案編碼 = UTF-8

總結

「三統一」原則:**檔案儲存編碼、頁面宣告編碼、傳輸編碼**三者合一,配合 Tomcat 全域過濾器,即可徹底根治 JSP 中文亂碼。強烈建議全棧統一採用 UTF-8(含資料庫 utf8mb4),避免跨系統編碼轉換地獄。

copyright © 萬盛學電腦網 all rights reserved
項目UTF-8 (推薦)GB18030
國際化支援完美支援所有語言僅支援中文為主
資料庫儲存需設定 utf8mb4需設定 gbk
前端框架相容Vue/React/Angular 預設易發生編碼轉換錯誤
檔案大小英文佔 1 byte,中文 3 bytes中文佔 2 bytes