确保JSP页面、请求处理（request.setCharacterEncoding(“UTF-8”)）、数据库连接（如JDBC URL添加?characterEncoding=UTF-8）及数据库本身均统一使用UTF-8编码。
在开发JSP网站时,遇到数据库乱码是常见问题，根本原因是字符编码不一致，以下是经过验证的完整解决方案，涵盖全链路编码配置：
核心问题定位
乱码通常发生在三个环节：
- 浏览器 ↔ JSP页面：HTTP请求/响应编码不匹配
- JSP ↔ 数据库连接：JDBC传输编码错误
- 数据库存储：表/字段字符集设置错误
全链路解决方案（UTF-8统一方案）
JSP页面层设置
<%-- 页面顶部强制声明 --%> <%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %> <html> <head> <%-- 双保险声明 --%> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> </head>
服务器容器配置（Tomcat示例）
关键配置：修改server.xml
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8" <!-- 解决GET乱码 -->
useBodyEncodingForURI="true" /> <!-- 兼容POST -->
请求编码过滤（强制拦截）
创建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.yourpackage.EncodingFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
数据库连接层（JDBC关键参数）
// MySQL示例（其他数据库类似）
String url = "jdbc:mysql://localhost:3306/yourdb?
useUnicode=true&
characterEncoding=UTF-8&
useSSL=false";
// PostgreSQL示例
String url = "jdbc:postgresql://localhost:5432/yourdb?characterEncoding=UTF-8";
数据库存储层配置
MySQL执行命令：
ALTER DATABASE yourdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 修改表编码 ALTER TABLE your_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Oracle执行命令：
ALTER DATABASE CHARACTER SET AL32UTF8;
特殊场景处理
GET请求乱码补救方案：
String param = new String(request.getParameter("param").getBytes("ISO-8859-1"), "UTF-8");
文件上传编码：
<form action="upload.jsp" method="post" enctype="multipart/form-data" accept-charset="UTF-8">
验证流程
- 测试页面：
test.jsp提交中文表单 - 数据库检查：直接查询数据是否正常存储
- 回显验证：从数据库读取并在页面显示
高级防护措施
- 连接池配置：Druid/C3P0需单独设置connectionInitSqls
<property name="connectionInitSqls" value="set names utf8mb4;"/>
- Nginx代理层：
http { charset utf-8; proxy_set_header Accept-Charset "utf-8"; } - IDE设置：
- Eclipse：Window > Preferences > General > Workspace > Text file encoding
- IntelliJ：File > Settings > Editor > File Encodings
故障排查清单
| 环节 | 检查点 | 验证命令/方法 |
|---|---|---|
| 浏览器 | 查看请求头Content-Type | F12网络面板 |
| JSP编译 | 查看生成的.java文件 | Tomcat work目录 |
| 数据库连接 | SHOW VARIABLES LIKE ‘char%’ | 执行SQL查询 |
| 表字段 | SHOW CREATE TABLE your_table | 检查字符集定义 |
经验提示：UTF-8与UTF8MB4区别
- MySQL的
utf8只支持3字节（缺失emoji等字符）- 必须使用
utf8mb4才能完整支持Unicode
引用说明
- Oracle官方字符集指南：Database Globalization Support Guide
- MySQL 8.0字符集文档：Chapter 10 Character Sets, Collations, Unicode
- RFC 3629：UTF-8, a transformation format of ISO 10646
- W3C编码标准：Character encodings
通过以上全链路配置,可彻底解决99%的中文乱码问题，实际部署时需确保各环节配置同步生效，特别注意新旧数据表的字符集统一，若仍遇异常，建议使用十六进制工具比对编码转换过程。
原创文章，发布者：酷盾叔，转转请注明出处：https://www.kd.cn/ask/39139.html
