您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計疑難解答

Java Web 中文亂碼徹底解決：UTF-8 編碼統一配置檢查清單

編輯：程式設計疑難解答

亂碼產生鏈路

瀏覽器請求 (編碼) → Tomcat 解碼 → Java 字串 → 業務邏輯 → 資料庫存儲 (編碼)
    ▲                                                                    │
    └──────────────────── 響應輸出 (編碼) ← 頁面渲染 (編碼) ←────────────┘

**任何一環編碼不一致即產生亂碼**。

統一 UTF-8 配置清單

層級	配置位置	關鍵設置
IDE/編輯器	File Encoding / Properties	Project Encoding = UTF-8
Java 源文件	javac 參數	`-encoding UTF-8` (Maven: `properties>project.build.sourceEncoding`)
Tomcat 請求解碼	server.xml <Connector>	`URIEncoding="UTF-8" useBodyEncodingForURI="true"`
Servlet 請求/響應	Filter / 代碼	`request.setCharacterEncoding("UTF-8"); response.setContentType("text/html;charset=UTF-8")`
JSP 頁面	頁面指令	`<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>`
HTML 輸出	<head>	`<meta charset="UTF-8">`
資料庫連接	JDBC URL	`?characterEncoding=utf8&useSSL=false` (MySQL)
資料庫表/列	DDL	`CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci`

快速驗證步驟

確認源文件確實保存為 UTF-8 (Notepad++/VS Code 右下角查看)。
瀏覽器開發者工具 Network 標籤查看 Request/Response Headers 中 Content-Type 是否含 charset=UTF-8。
資料庫客戶端執行 SHOW VARIABLES LIKE 'character%'; 確認連接/庫/表編碼。

參考資源

CSDN 系統總結：Java Web 字符編碼問題完整解決方案

上一篇文章： C 語言學號存儲選擇：字元陣列 vs 長整型 —— 非數值型標識符應用字串
下一篇文章： Android EditText 不顯示輸入文字：三大常見原因與解決方案

程式設計疑難解答

$JavaScript split 正則陷阱：/[^\,]+/g 分割輸出為何是「-，-，-，-」？$ JavaScript split 正則陷阱：/[^\,]+/g 分割輸出為何是「-，-，-，-」？

代碼 var colorText = red,blue,g

Maven 創建項目報錯：插件版本在倉庫找不到

錯誤現象執行 mvn archetype:generate

Eclipse 強制關閉後無法啟動：JRE 路徑/配置損壞，重裝或修復配置

現象運行卡頓，強制關閉 Eclipse 進程。

MFC 圖片顯示不出來：GDI+ 初始化缺失、路徑錯誤、繪製時機錯誤三大核心原因與完整修正代碼

核心原因排查清單 GDI+ 未初始化 / 未關閉