JSP中文乱码简单解决方法|新手快速搞定的超实用技巧

先搞定JSP页面本身的编码：一步到位设置UTF-8

很多人刚开始写JSP时，最容易忽略的就是页面顶部的page指令——要么忘了写，要么编码设错。我自己刚学的时候也犯过这错：当年写一个简单的欢迎页面，把pageEncoding写成GBK，结果页面打开全是乱码，查了半小时才反应过来“哦，编码设错了”。

你记好，JSP页面的编码设置有两个必须同步的参数：contentType里的charset和pageEncoding，俩都要设成UTF-8。正确的写法是：

为什么要设两个？其实pageEncoding是告诉JSP引擎“编译这个页面时用什么编码”，而contentType是告诉浏览器“解析这个页面时用什么编码”——俩都设成UTF-8，才能保证从编译到展示的全流程编码一致。小宇当时就是只设了contentType，没加pageEncoding，结果JSP引擎用默认的ISO-8859-1编译了页面，导致输出的内容全乱了，补上pageEncoding="UTF-8"后，页面立马正常显示“用户登录”四个字，他当时眼睛都亮了：“原来这么简单？我之前居然没注意！”

顺带提一嘴，现在很多IDE（比如IDEA）新建JSP页面时，会自动帮你加上这行指令，但保险起见，你还是要手动检查一遍——毕竟我见过不止一个人把UTF-8写成utf8（少了横杠），结果照样乱码。

处理Servlet和请求响应的编码：别让数据在传输中变乱

要是页面编码对了，但提交表单、访问Servlet时中文还是乱码，那问题肯定出在请求/响应的编码没设置。我之前做一个用户注册功能时就踩过坑：用户填的“李小红”提交到Servlet后，打印出来变成“鏉庡皬绾�”，查了半天才发现——我忘了给request设置编码。

这里分两种情况说：

POST请求：先设编码再拿参数

对于POST方式提交的表单，一定要在获取参数之前调用request.setCharacterEncoding("UTF-8")。比如小宇做的登录功能，他的Servlet代码一开始是这样的：

String username = request.getParameter("username"); // 先拿参数
request.setCharacterEncoding("UTF-8"); // 后设编码

结果可想而知，“张三”变成乱码。后来我让他把setCharacterEncoding移到getParameter前面，立马就好了——因为setCharacterEncoding要在第一次获取参数前生效，否则没用。

GET请求：Tomcat版本要注意

如果是GET请求（比如地址栏传参），Tomcat 8及以上版本默认会用UTF-8解析参数，一般不会乱码；但如果是Tomcat 7或更老的版本，就得改conf/server.xml里的Connector标签，加个URIEncoding="UTF-8"：

 connectionTimeout="20000"
 redirectPort="8443"
 URIEncoding="UTF-8" /> <!-
加这行 >

还有response的编码，要记得设置response.setContentType("text/html;charset=UTF-8")——这是告诉浏览器“我返回的内容用UTF-8解析”，不然即使Servlet处理对了，浏览器也可能用默认编码（比如GBK）显示，照样乱码。

小宇当时就是没给response设编码，导致Servlet返回的“登录成功”显示成乱码，加上这行代码后，页面终于正常了。

数据库连接的编码匹配：从源头解决存储乱码

要是前面都设对了，但从数据库读出来的中文还是乱码，那百分百是数据库连接的编码没匹配。我之前帮一个电商项目调过这问题：商品名称存在MySQL里是“华为Mate 60”，但读出来显示成“鍗庝负Mate 60”，查连接字符串才发现——没加characterEncoding=UTF-8。

解决方法很简单：在JDBC连接字符串里加两个参数：useUnicode=true&characterEncoding=UTF-8。比如：

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

数据库和表的字符集也得设对——推荐用utf8mb4（比utf8多支持emoji和一些生僻字）。比如创建数据库时：

CREATE DATABASE shop DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;

创建表时：

CREATE TABLE goods (name VARCHAR(255) NOT NULL) DEFAULT CHARSET utf8mb4;

小宇当时就是连接字符串没加这俩参数，结果从数据库读出来的中文全乱了，加上之后重启项目，“华为Mate 60”终于正常显示，他拍着大腿说：“原来数据库这里也要设！我之前光盯着JSP了。”

给你整理了个常见乱码场景&解决方法表，一眼就能看懂：

这些方法我和小宇都亲测有效——他当时用了不到20分钟就把所有乱码问题解决了，还跟我说：“原来之前想复杂了，以为要学什么高深的编码原理，没想到就这几步！” 你可以照着试一遍，要是遇到问题，欢迎留言告诉我——毕竟乱码这事儿，有时候就是“一层窗户纸”，捅破了就简单。对了，记得先检查page指令和数据库连接字符串，这俩是最容易忘的点！

我发现很多人解决数据库乱码时，都有个误区——以为连接字符串加了useUnicode=true&characterEncoding=UTF-8就万事大吉，但其实这只是“传输环节”的设置，要是数据库本身的字符集没对齐，数据存的时候就已经乱了，读出来能对才怪。

比如去年帮朋友小周调电商项目，他说连接字符串明明加了UTF-8参数，可商品名称“草莓奶茶”从数据库读出来还是“鑺卞崏鍗风偣”。我打开他的数据库一看，好家伙，数据库用的是GBK字符集，表也是GBK——相当于你用UTF-8的管道传数据，但仓库本身是GBK的“货架”，数据存进去时已经被转换成GBK了，再用UTF-8读出来，可不就是乱码？后来我让他把数据库和表的字符集都改成utf8mb4（注意不是utf8），结果“草莓奶茶”立马正常显示。

为什么要选utf8mb4？因为普通的utf8只支持1-3个字节的字符，像emoji（比如“🍓”）或者生僻字（比如“垚”“淼”）都是4字节，存进去会变成问号；而utf8mb4能支持4字节字符，覆盖所有中文和特殊符号。还有个细节要注意：数据库改了字符集，表也要同步改——小周一开始只改了数据库，没改表，结果部分商品名称还是乱码，后来把表也改成utf8mb4才彻底解决。

简单说，数据库乱码的解决逻辑是“传输+存储”双对齐：连接字符串要设UTF-8，数据库和表的字符集要设utf8mb4，缺一个环节都不行。你要是遇到类似问题，先查这两个点，九成能解决。

页面已经设置了UTF-8，为什么中文还是乱码？

可能是两个常见原因：一是编码参数拼写错误（比如把“UTF-8”写成“utf8”，少了中间的横杠，部分环境无法识别）；二是漏设了pageEncoding参数——即使contentType设了UTF-8，若pageEncoding没同步设置，JSP引擎会用默认的ISO-8859-1编译页面，导致输出乱码。另外要检查参数顺序，确保page指令里同时包含contentType和pageEncoding。

GET请求提交中文时乱码，该怎么解决？

如果是Tomcat 8及以上版本，GET请求默认用UTF-8解析参数，一般不会乱码；若使用Tomcat 7或更老版本，需要修改Tomcat安装目录下conf/server.xml里的Connector标签，添加URIEncoding="UTF-8"参数（如：），这样就能让Tomcat用UTF-8解析GET请求的参数。

数据库连接字符串加了UTF-8，为什么读出来还是乱码？

除了连接字符串要加useUnicode=true&characterEncoding=UTF-8，还要检查数据库和表的字符集：数据库应设置为utf8mb4（比utf8支持更多字符，包括emoji和生僻字），表的字符集也要同步设为utf8mb4。如果数据库本身用的是GBK或其他编码，即使连接字符串设了UTF-8，数据存储时已经乱了，读出来自然也会乱码。

UTF-8和utf8有什么区别？为什么不能写成utf8？

“UTF-8”是标准的编码名称（包含中间的横杠），而“utf8”是简化写法。部分环境（如JSP引擎、数据库驱动）只能识别标准的“UTF-8”，若写成“utf8”可能导致编码设置不生效，进而出现乱码。 始终使用“UTF-8”的标准写法。

YUANLEISVIP

收藏 链接