解决 Web 开发中常见的中文乱码问题

为什么会有乱码

  产生乱码的原因一句话就能说明白:

编码和解码使用的字符集不同。

  比如说在后端把字符串 "你好,世界" 按照 UTF-8 进行编码,但是前端却按照 GB2312 进行解码,那自然会产生乱码。

解决 response 中的乱码

  因为目前大部分浏览器都是采用 UTF-8 编码的,所以向浏览器输出中文字符,只需在 doGet 方法中指定 Content-Type:text/html;charset=utf-8。

response.setContentType("text/html;charset=utf-8");

解决 request 中的乱码

GET

  获取 HTTP 请求中的中文参数时可能会有乱码,所以先将字符串变回字节数组,然后再按照 UTF-8 进行编码。假设 HTTP 请求中带了一个 username 的参数,那么就需要在 doGet 方法中进行如下处理

String username = request.getParameter("username");
// Tomcat 默认的编码方式是 ISO8859-1
username = new String(username.getBytes("iso8859-1"),"utf-8");

  问题是,在实际的应用场景中 HTTP 请求携带的参数可能有多个,所以就不能只针对某个参数进行修改。解决的方案是使用装饰器模式,写一个 HttpServletRequest 的装饰器类,经过装饰的 request 对请求中的任何参数都能进行编码的处理。

// 装饰器类,用来设置 GET 请求的编码
public class EncodingRequest extends HttpServletRequestWrapper{

    private HttpServletRequest request;    // 真正的 request 对象
    
    public EncodingRequest(HttpServletRequest request) {
        super(request);
        this.request = request;
    }
    
    @Override
    public String getParameter(String name) { // 覆写 getParameter 方法,将所有参数的编码设置为 UTF-8
        String value = request.getParameter(name);
        try {
            value = new String(value.getBytes("iso-8859-1"),"utf-8");
        } catch (UnsupportedEncodingException e) {
            throw new RuntimeException(e);
        }
        return value;
    }
}

  然后用一个 Filter 对所有的请求进行编码的处理,然后再把处理过后的 request 对象传递给 Servlet:

@WebFilter("/*")
public class EncodingFilter implements Filter {

    public void destroy() {}

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        if (req.getMethod().equals("GET")) { // 处理 GET 请求的编码
            EncodingRequest encodingReq = new EncodingRequest(req);
            // 注意这里传递的是 EncodingRequest 对象
            chain.doFilter(encodingReq, response);
        }
        if (req.getMethod().equals("POST")) { // 处理 POST 请求的编码
            request.setCharacterEncoding("utf-8");
            chain.doFilter(request, response);
        }
    }

    public void init(FilterConfig fConfig) throws ServletException {}

}

POST

  因为大多数情况下我们在 doPost 方法内都会调用 doGet 方法,因此按照上面的做法就能解决 POST 请求中的中文乱码问题。如果使用 Spring 进行开发,那么有 POST 请求乱码的专门解决方案。在 web.xml 中添加如下配置:

    <!-- POST 乱码过滤器 -->
    <filter>
        <filter-name>CharacterEncodingFilter</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>
    </filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

  这样就可以解决 POST 的乱码问题了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,198评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,663评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,985评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,673评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,994评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,399评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,717评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,407评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,112评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,371评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,891评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,255评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,881评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,010评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,764评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,412评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,299评论 2 260

推荐阅读更多精彩内容

  • 编码问题一直困扰着开发人员,尤其在 Java 中更加明显,因为 Java 是跨平台语言,不同平台之间编码之间的切换...
    x360阅读 2,393评论 1 20
  • 主要内容 1. 字符编码理论简述 本文主要是围绕Web开发中涉及到的中文编码这一常见问题展开,包括了对字符编码基础...
    topgunviper阅读 12,566评论 5 28
  • 最近一个项目,测试时采用的Windows下的Tomcat服务器,上传中文文件正常;部署时用到了Linux服务器,上...
    Jackeroo阅读 3,718评论 1 3
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,087评论 18 139
  • 妈呀,心里好慌,连续几天睡5个小时。这样的情况出现在高考,找工作,还有第二次工作面对找对象的压力的时候。那时候是对...
    onetwo3go阅读 193评论 0 0