萬盛學電腦網

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

JSP + MySQL 中文亂碼 POST 提交完整解決方案:編碼鏈路全鏈路排查

問題現場還原

index.jsp (GB2312) --POST表單--> mysql_insert.jsp (UTF-8) --> MySQL (utf8mb4)
現象:中文入庫變亂碼,頁面顯示亂碼,英文正常

編碼鏈路診斷圖

瀏覽器編碼(GB2312) → HTTP Body (GB2312 URL編碼) 
    → Tomcat解碼(默認ISO-8859-1/配置UTF-8) → Java字符串(UTF-16)
    → JDBC發送(連接串characterEncoding) → MySQL解碼(連接字符集)
    → 存儲(表字符集) → 查詢 → 反向鏈路 → 瀏覽器渲染

錯誤配置分析 (原代碼問題)

環節原代碼設置問題
index.jsp`contentType="text/html;charset=gb2312"`頁面編碼 GB2312,表單提交按 GB2312 編碼
mysql_insert.jsp`pageEncoding="UTF-8"` 但**無** `request.setCharacterEncoding("UTF-8")`Tomcat 按默認 ISO-8859-1 解碼 GB2312 的字節流 → 亂碼
JDBC 連接串`?user=root&password=123456` **缺少** `useUnicode=true&characterEncoding=utf8mb4`驅動默認 latin1,中文存入變 ???
MySQL 會話`stmt.executeQuery("SET NAMES UTF8")`UTF8 非 utf8mb4 (不支持 Emoji/生僻字),且執行時機晚於首條 SQL
web.xml / server.xml無字符編碼 Filter、Connector 無 URIEncoding全局無保障

徹底修復方案 (統一 UTF-8 全鏈路)

1. 統一頁面編碼為 UTF-8

<!-- 所有 JSP 統一 -->
<%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<!DOCTYPE html>
<html><head><meta charset="UTF-8"></head>...

棄用 GB2312/GBK**:不支持 Emoji、生僻字,國際化困難,UTF-8 為唯一標準。

2. 全局字符編碼過濾器 (web.xml 第一順位)

<filter>
    <filter-name>EncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param>
    <init-param><param-name>forceEncoding</param-name><param-value>true</param-value></init-param>
</filter>
<filter-mapping>
    <filter-name>EncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

無 Spring 環境自寫 Filter (參考文章 67882 代碼)。

3. Tomcat Connector 配置 (server.xml)

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

4. JDBC 連接串標準化

jdbc:mysql://localhost:3306/html_db?
    useUnicode=true&
    characterEncoding=utf8mb4&
    serverTimezone=Asia/Shanghai&
    useSSL=false&
    allowPublicKeyRetrieval=true&
    rewriteBatchedStatements=true
  • characterEncoding=utf8mb4:驅動發送/接收數據使用 utf8mb4
  • useUnicode=true:啟用 Unicode 支持
  • 移除代碼中 `SET NAMES UTF8`,連接串已涵蓋

5. 數據庫對象字符集檢查與修正

-- 檢查
SHOW CREATE DATABASE html_db;
SHOW CREATE TABLE person_tb;
SHOW FULL COLUMNS FROM person_tb;

-- 修正 (若非 utf8mb4)
ALTER DATABASE html_db CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
ALTER TABLE person_tb CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 或逐列修改
ALTER TABLE person_tb MODIFY name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

6. 修正後 mysql_insert.jsp 關鍵代碼

<%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<%@ page import="java.sql.*,java.util.*" %>
<%
    // Filter 已處理 request 編碼,此行可省略,保留為雙重保險
    request.setCharacterEncoding("UTF-8"); 
    
    String id = request.getParameter("id");
    String name = request.getParameter("name"); // 此處已正確解碼
    String sex = request.getParameter("sex");
    String age = request.getParameter("age");
    
    // 連接池模式 (生產必須),此處簡化為直連
    String url = "jdbc:mysql://localhost/html_db?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai";
    try (Connection conn = DriverManager.getConnection(url, "root", "123456");
         PreparedStatement ps = conn.prepareStatement(
             "INSERT INTO person_tb (id, name, sex, age) VALUES (?, ?, ?, ?)")) {
        
        ps.setString(1, id);
        ps.setString(2, name); // 參數化查詢,無編碼/注入問題
        ps.setString(3, sex);
        ps.setInt(4, Integer.parseInt(age));
        ps.executeUpdate();
        
        // 查詢回顯
        try (ResultSet rs = conn.createStatement().executeQuery("SELECT * FROM person_tb")) {
            while (rs.next()) {
                out.println("ID: " + rs.getString("id") + "<br/>");
                out.println("姓名: " + rs.getString("name") + "<br/>");
                // ...
            }
        }
    } catch (Exception e) {
        e.printStackTrace();
        out.println("錯誤: " + e.getMessage());
    }
%>

驗證清單

✅ 瀏覽器 → Network → Request Payload: username=%E4%B8%96%E7%95%8C%E6%9D%AF (UTF-8 URL編碼)
✅ Tomcat 訪問日志 / 遠程調試: request.getParameter("username") = "世界杯"
✅ MySQL 客戶端: SELECT * FROM person_tb; 顯示正確中文
✅ MySQL 變量: character_set_client/connection/results/database = utf8mb4
✅ 頁面顯示: 瀏覽器渲染正常,無亂碼

避坑總結

  1. **全鏈路統一 UTF-8 (utf8mb4)**,不要混用 GBK/GB2312
  2. **Filter 統一請求響應編碼**,`forceEncoding=true`
  3. **Tomcat `URIEncoding="UTF-8"` 解決 GET 亂碼**
  4. **JDBC 連接串顯式指定 `characterEncoding=utf8mb4`**
  5. **數據庫/表/列字符集 utf8mb4**,而非 utf8
  6. **使用 PreparedStatement 參數化查詢**,杜絕字符串拼接 SQL
  7. **IDE/構建工具/文件保存編碼統一 UTF-8**
copyright © 萬盛學電腦網 all rights reserved