Web开发中页面出现乱码的解决（Java Web学习笔记：需在编译时用 -encoding utf-8）

1 引言

Web开发的页面出现了乱码，一直不愿写出来，因为网上的解决方案太多了。但本文的所说的页面乱码问题，则是与网上的大多数解决方案不一样，使用通常的方法解决不了。这些通常的解决方法包括：

在出现乱码的jsp页面源文件的头部写：<% request.setCharacterEncoding("utf-8"); %>；
在出现乱码的jsp页面源文件中的<head>标签中写入：

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

于是，本博文的写作动力就有了。

2 乱码表现、原因分析及解决

2.1 乱码表现

本项目是基于Struts 2构建的，struts.xml中涉及到乱码的action为getBooks，内容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC"-//Apache Software Foundation//DTD Struts Configuration 2.3//EN""http://struts.apache.org/dtds/struts-2.3.dtd">
<struts><package name="teststruts" extends="struts-default" namespace="/"><action name="login" class="com.rob.teststruts.action.LoginAction"><result name="error">/error.jsp</result><result name="success">/welcome.jsp</result></action><action name="getBooks" class="com.rob.teststruts.action.GetBooksAction"><result name="login">/loginForm.jsp</result><result name="success">/showBook.jsp</result></action></package>
</struts>

展示页面showBook.jsp的内容如下：

<%@ page language="java" pageEncoding="UTF-8" errorPage="" %>
<%@ page import="java.util.*, com.opensymphony.xwork2.util.*" %>
<!DOCTYPE html>
<html><head><title>作者李刚的图书</title></head><body><table border="1" width="360"><caption>作者李刚的图书</caption><%// 获取封装输出信息的ValueStack对象ValueStack vs = (ValueStack)request.getAttribute("struts.valueStack");String[] books = (String[])vs.findValue("books");for (String book: books) {%><tr><td>书名：</td><td><%=book%></td></tr><%}%></table></body>
</html>

项目部署、启动Tomcat后，出现如下乱码：
乱码表现

2.2 原因分析

利用引言中介绍的两种方法无法解决该问题，乱码仍然出现。忽然想到，BookService.java源文件本身是UTF-8编码，在Windows cmd下编译时没指定编码方式，会默认GBK编码，但对该文件的编译缺没报错。若一个UTF-8编码的java源文件中的注释中包含汉字，则编译时会提示如下：
在这里插入图片描述
所以，对源文件BookService.java来说，其中只有字符串中有汉字，没提示报错。最大的原因在于该文件编译时没指定utf-8编码。BookService.java的内容如下：

package com.rob.teststruts.service;public class BookService {private String[] books = new String[] {"疯狂Java讲义","疯狂Android讲义","轻量级Java EE 企业应用实战","疯狂Ajax讲义","疯狂XML讲义",};// business logic methodpublic String[] getLeeBooks(){return books;}
}

2.3 解决

对源文件BookService.java按如下方式编译，指定编码方式：

javac -encoding utf-8 -d classes src\com\rob\teststruts\service\BookService.java

用生成的BookService.class文件替换部署环境中的旧的BookService.class，重启Tomcat，访问网址，成功解决乱码，如下图：
在这里插入图片描述

3 总结

这是个共性问题，只要是基于Java Web开发的项目，只要utf-8编码的源文件编译时没指定utf-8编码方式，都会遇到这个乱码问题。该问题用通常的乱码解决方法行不通。这里愿意与大家交流，有问题请大家私信。

大家注意，只要源文件是utf-8编码格式的，最好在编译时也指定utf-8编码方式。

本文例子选自书籍《Struts 2.x 权威指南》¹第29页。书中代码未包含import部分、package部分，对编译过程也没提到，大家在阅读时要注意自行补上。实际上，有一定基础的人，都可以毫无困难地复现书中例子。在此，感谢作者提供的例子，虽然该例子没考虑到编码问题，这不是作者的问题。

李刚. Struts 2.x 权威指南. 第3版. 北京: 电子工业出版社, 2012.10: 29. ↩︎