服务器之家

服务器之家 > 正文

JavaWeb乱码问题的终极解决方案(推荐)

时间:2021-07-30 11:28     来源/作者:江南一点雨

前言

经常有读者在公众号上问 javaweb 乱码的问题,昨天又有一个小伙伴问及此事,其实这个问题很简单,但是想要说清楚却并不容易,因为每个人乱码的原因都不一样,给每位小伙伴都把乱码的原因讲一遍也挺费时间的,因此,松哥今天决定写一篇文章,和大伙好好捋捋 javaweb 中的乱码问题。

对于一些老司机而言,其实并不太容易遇到乱码问题,但是对于一些新手来说,乱码几乎是家常便饭,而且每当乱码时,网上搜了一大堆解决方案,发现自己的问题还是没能解决,其实这就是平时研究代码不求甚解导致的,乱码问题,也要去分析,然后才能对症下药,才能药到病除。

整体思路

首先出现乱码之后,要先去确认乱码的地方,当一个网页上出现乱码,有可能是浏览器显示问题,也有可能是 java 编码问题,也有可能数据库中的数据本身就是乱码的,所以我们要做的第一件事就是确认乱码发生的位置,缩小 bug 范围,通过打印日志或者 debug 首先去确认乱码发生的位置,然后再去进一步解决,一般来说,乱码的原因大致上可以分为两类:

  • 请求乱码
  • 响应乱码

请求乱码,可能是因为参数放在 url 地址中乱码,也有可能是参数放在请求体中乱码,不同传参方案也对应了不同的乱码解决方案。如果是响应乱码,那么原因就会比较多了,一般来说,有如下几种可能的原因:

  • 数据库本身乱码
  • 数据在 java 代码中乱码
  • 数据在浏览器显示的时候乱码
  • 数据在从 java 应用传到数据库的过程中乱码

对于不同的乱码原因,会有不同的解决方案,对症下药,才能药到病除,所以当出现乱码时,大家要做的第一件事就是分析乱码发生的原因,找到原因了,才能找到解决方案。

基本原则

发生乱码是因为各自编码不同导致的,所以,大家首先要有一个良好的开发习惯,项目编码,文件编码都要统一起来,松哥有个同事就因为 freemarker 乱码,找了半天没找到原因,后来在松哥建议下修改了项目编码,乱码问题才解决了,一般来说,公司制度稍微成熟一些,都会对项目编码,文件编码有硬性规定的。在eclipse 中,设置项目编码方式如下(工程的编码要提前设置,如果项目已经开发一半再去设置,已有的中文就会乱码):

window->preferences->general

JavaWeb乱码问题的终极解决方案(推荐)

然后对于 jsp 文件也需要提前设置好编码方式,如下:

JavaWeb乱码问题的终极解决方案(推荐)

这是在 eclipse 中设置文件编码,如果是在 intellij idea中,则不需要设置jsp文件编码,因为默认就是 utf-8,只需要提前设置下工程编码即可:

JavaWeb乱码问题的终极解决方案(推荐)

除了开发工具的编码,数据库的编码也要统一,一般来说,主要是设置一下数据库的编码和数据表的编码,如下:

设置数据库编码:

?
1
create database `vhr` default character set utf8;

设置数据表编码:

?
1
2
3
4
5
6
drop table if exists `adjustsalary`;
create table `adjustsalary` (
 `id` int(11) not null auto_increment,
 `eid` int(11) default null,
 primary key (`id`),
) engine=innodb default charset=utf8;

这些是准备工作,这些工作做好了,还是有可能会遇到乱码问题,接下来我们就具体问题具体分析。

请求乱码

请求乱码,就是说数据在浏览器中显示是正常的,但是传到 java 后端之后,就乱码了,这种乱码一般来说,分为两种:

  • 参数放在 url 地址中导致的乱码
  • 参数放在请求体中导致的乱码

两种乱码原因,对应了两种不同的解决方案。分别来看。

url 地址中的参数乱码

这种乱码主要发生在 get 请求中,因为在 get 请求中我们一般通过 url 来传递参数,这个问题可以在代码中解决,但是太过于麻烦,因此一般我们直接在tomcat配置中解决,修改 tomcat的conf/server.xml 文件,修改 url 编码格式,如下:

JavaWeb乱码问题的终极解决方案(推荐)

这样就可以搞定 url 地址中的参数乱码。

请求体中的参数乱码

请求体中的参数乱码,我们可以在解析参数之前通过设置 httpservletrequest 的编码来解决,如下:

?
1
request.setcharacterencoding("utf-8");

但是一样也太过于麻烦,所以如果是普通的 servlet/jsp 项目,我们就可以直接定义一个过滤器来处理,如下:

?
1
2
3
4
5
6
7
public class encodingfilter implements filter {
 @override
 public void dofilter(servletrequest request, servletresponse response, filterchain chain) throws ioexception, servletexception {
  request.setcharacterencoding("utf-8");
  chain.dofilter(request, response);
 }
}

过滤器配置:

?
1
2
3
4
5
6
7
8
<filter>
 <filter-name>encodingfilter</filter-name>
 <filter-class>org.sang.filter.encodingfilter</filter-class>
</filter>
<filter-mapping>
 <filter-name>encodingfilter</filter-name>
 <url-pattern>/*</url-pattern>
</filter-mapping>

在工程编码和jsp/html编码都没问题的情况下,请求乱码基本上就是这两种情况。

响应乱码

如果在浏览器上加载页面看到了乱码,大家首先要确认在从服务端往浏览器写数据的前一刻,这个数据还没有乱码(即数据库中查询出来的数据是ok的,没有发生乱码的问题),那么对于这种乱码,我们只需要设置响应数据的 contenttype 就可以了,如下:

?
1
response.setcontenttype("text/html;charset=utf-8");

如果从数据库中查询出来的数据就是乱码的,那么就需要去确认数据库中的编码是否 ok 。

框架处理

前面提到的方案,都是在 servlet/jsp 项目中我们可以采用的方案,在 ssm 框架中当然也可以使用,但是,springmvc 框架本身也提供了一个过滤器,我们可以借用这个过滤器更加高效的解决响应乱码问题,如下:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<filter>
 <filter-name>encoding</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>forcerequestencoding</param-name>
  <param-value>true</param-value>
 </init-param>
 <init-param>
  <param-name>forceresponseencoding</param-name>
  <param-value>true</param-value>
 </init-param>
</filter>
<filter-mapping>
 <filter-name>encoding</filter-name>
 <url-pattern>/*</url-pattern>
</filter-mapping>

当然,上面这段配置并不能代替 tomcat 中 conf/server.xml 中的编码配置,如果是在 spring boot 中,配置可以更加简单,只需要在 application.properties 中添加如下配置即可:

?
1
2
3
server.tomcat.uri-encoding=utf-8
spring.http.encoding.force-request=true
spring.http.encoding.force-response=true

其他乱码

其他乱码主要是指使用一些第三方框架导致的乱码,例如使用 alibaba 的 fastjson,开发者就需要在配置 httpmessageconverter 时指定编码格式,否则就有可能出现乱码,这种第三方框架的乱码松哥没法穷举,大伙在使用时需要注意看官方文档,fastjson 的 httpmessageconverter 配置如下:

?
1
2
3
4
5
6
7
8
9
@bean
fastjsonhttpmessageconverter fastjsonhttpmessageconverter() {
 fastjsonhttpmessageconverter converter = new fastjsonhttpmessageconverter();
 fastjsonconfig config = new fastjsonconfig();
 config.setcharset(charset.forname("utf-8"));
 converter.setfastjsonconfig(config);
 converter.setdefaultcharset(charset.forname("utf-8"));
 return converter;
}

一个隐蔽的乱码

除了前面介绍的这几种乱码之外,还有一个比较隐蔽的乱码,容易被很多初学者忽略的地方,就是数据在从 java 应用传递到 mysql 的过程中,发生了乱码,这种问题一般在 windows 上不易发生,如果数据库装在 linux 上,则这个问题就很容易发生,数据在代码中命名没有乱码,存到 mysql 上就乱码了,但是如果直接使用 navicat 等工具往 mysql 上存储数据,又不会乱码,或者 mysql 中数据没有乱码,但是用 java 查询出来就乱码了,这种都是数据在 应用 和 数据库 之间传递时发生了乱码,解决方式很简单,在数据库连接地址上指定编码即可,如下:

?
1
db.url=jdbc:mysql:///yuetong?useunicode=true&characterencoding=utf-8

大致就这些,还有一些非常偶尔的情况可能会用到 @requestmapping 注解中的 produces 属性,在这里指定数据类型即可。

好了,差不多就这些,下次有人问你为啥我的又乱码了,直接把这篇文章甩给他。大伙有什么解决乱码的独门密器也可以一起来讨论。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对服务器之家的支持。

原文链接:https://www.cnblogs.com/lenve/p/10675044.html

标签:

相关文章

热门资讯

2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全
2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全 2019-12-26
yue是什么意思 网络流行语yue了是什么梗
yue是什么意思 网络流行语yue了是什么梗 2020-10-11
背刺什么意思 网络词语背刺是什么梗
背刺什么意思 网络词语背刺是什么梗 2020-05-22
苹果12mini价格表官网报价 iPhone12mini全版本价格汇总
苹果12mini价格表官网报价 iPhone12mini全版本价格汇总 2020-11-13
2021德云社封箱演出完整版 2021年德云社封箱演出在线看
2021德云社封箱演出完整版 2021年德云社封箱演出在线看 2021-03-15
返回顶部