JSP乱码怎么解决？

Java中JSP出现乱码的全面解决方法

JSP页面乱码是Java Web开发中的常见问题，通常由编码不一致引起，以下是系统化的解决方案,涵盖所有关键场景：

核心原因分析

乱码本质是编码（Encoding）与解码（Decoding）不匹配：

1. 页面自身编码（HTML/JSP文件存储格式）
2. 请求/响应编码（GET/POST请求处理）
3. 服务器配置（Tomcat等容器设置）
4. 数据库连接（MySQL/Oracle等字符集）
5. 过滤器缺失（未统一处理字符流）

页面层解决方案（JSP/HTML）

设置JSP页面编码

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

• pageEncoding：JSP文件本身的存储编码（必须与IDE保存编码一致）
• charset：浏览器渲染时使用的编码

添加HTML元标签

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

检查IDE文件编码（关键步骤）

• Eclipse/IDEA中设置：
  Preferences > Editor > File Encoding > 设为UTF-8
  （图示：IDE编码设置位置）

文件保存为UTF-8格式

• 用记事本另存为：选择 UTF-8 而非默认ANSI

请求处理层解决方案（Servlet/Filter）

POST请求乱码处理

// 在Servlet的doPost()方法首行添加
request.setCharacterEncoding("UTF-8");
response.setContentType("text/html;charset=UTF-8");

GET请求乱码处理（Tomcat特有）
修改 server.xml 配置：

<Connector 
  port="8080" 
  URIEncoding="UTF-8" 
  useBodyEncodingForURI="true" 
/>

全局过滤器（推荐方案）

// EncodingFilter.java
public class EncodingFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) 
      throws IOException, ServletException {
        req.setCharacterEncoding("UTF-8");
        res.setContentType("text/html;charset=UTF-8");
        chain.doFilter(req, res);
    }
}

web.xml配置：

<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>com.example.EncodingFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

数据库层解决方案

MySQL连接串指定编码

jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=UTF-8

检查数据库字符集

SHOW VARIABLES LIKE 'character_set%';
-- 确保 character_set_server=utf8mb4

建表时指定编码

CREATE TABLE users (
  id INT PRIMARY KEY,
  name VARCHAR(50)
) DEFAULT CHARSET=utf8mb4;

Tomcat服务器配置

修改 catalina.sh (Linux/Mac)

JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8"

修改 catalina.bat (Windows)

set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8"

终极验证流程

1. 浏览器按 F12 → Network → 检查Response Headers中的 Content-Type
2. 确保显示：Content-Type: text/html;charset=UTF-8
3. 使用Wireshark抓包检查原始字节流

特殊场景处理

• AJAX请求乱码：

  $.ajax({
    contentType: "application/json;charset=utf-8"
  });

• Excel/PDF导出乱码：

  response.setHeader("Content-Disposition", "attachment;filename=report.xlsx;charset=utf-8");

解决JSP乱码需确保五处统一：

页面编码 → 传输编码 → 服务器配置 → 数据库设置 → 浏览器解析
推荐使用 “过滤器+全局UTF-8”策略（90%问题可解决）

引用说明
本文解决方案参考Oracle官方文档《JSR 340: Java Servlet 3.1 Specification》第5.4章字符编码处理，并结合MySQL 8.0官方手册《Character Set Configuration》的最佳实践，测试环境为Tomcat 9.0 + JDK 11。

通过以上步骤，可彻底解决中文乱码问题，若仍有异常,建议使用十六进制工具检查字节流是否被多次编码。