Servlet输出问号问题全面解析字符编码不匹配导致中文乱码的解决方案与实践技巧

威震华夏关云长

引言

在Java Web开发中，Servlet作为核心技术之一，广泛应用于服务器端处理。然而，开发者在处理中文字符时经常遇到输出问号（”?“）或乱码的情况，这不仅影响用户体验，还可能导致数据丢失或错误。这种问题通常源于字符编码不匹配，涉及请求编码、响应编码、数据库编码以及URL编码等多个方面。本文将全面分析Servlet中中文乱码问题的根源，并提供系统性的解决方案与实践技巧，帮助开发者彻底解决这一常见但棘手的问题。

问题根源分析

要解决Servlet中的中文乱码问题，首先需要理解其产生的根本原因。字符编码不匹配是导致乱码的核心因素，具体表现在以下几个方面：

字符编码基础

计算机内部存储的所有数据都是二进制形式，而字符编码则是将字符映射为二进制数据的规则。常见的字符编码包括：

• ASCII：美国信息交换标准代码，仅包含英文字母、数字和一些符号，共128个字符。
• ISO-8859-1：扩展ASCII，包含西欧语言字符，单字节编码。
• GB2312/GBK/GB18030：中文字符编码标准，其中GBK是GB2312的扩展，GB18030则更为全面。
• Unicode：包含世界上所有字符的编码标准，有多种实现形式如UTF-8、UTF-16、UTF-32等。
• UTF-8：Unicode的一种变长编码实现，兼容ASCII，是目前互联网上使用最广泛的编码。

编码不匹配的场景

在Servlet中，编码不匹配主要发生在以下场景：

1. 请求编码不匹配：浏览器发送请求时使用的编码与服务器解析请求时使用的编码不一致。
2. 响应编码不匹配：服务器生成响应时使用的编码与浏览器解析响应时使用的编码不一致。
3. 数据库编码不匹配：应用程序与数据库交互时使用的编码与数据库内部存储数据的编码不一致。
4. URL编码不匹配：URL中的中文字符编码与服务器解析URL时使用的编码不一致。

编码转换过程

当字符在不同编码之间转换时，如果目标编码不包含源编码中的某些字符，就会出现信息丢失或替换为问号的情况。例如，当中文字符使用ISO-8859-1编码（不包含中文字符）进行处理时，会被替换为”?“。

常见乱码场景

在实际开发中，中文乱码问题可能出现在多个环节，以下是几种常见的乱码场景：

1. POST请求参数乱码

当通过表单提交包含中文字符的POST请求时，如果未正确设置请求编码，服务器端获取的参数值可能会变成乱码。

2. // 示例：未设置请求编码导致的乱码
3. protected void doPost(HttpServletRequest request, HttpServletResponse response)
4.     throws ServletException, IOException {
5.     String chineseParam = request.getParameter("chineseParam");
6.     // 如果浏览器使用UTF-8编码发送请求，而服务器默认使用ISO-8859-1解析，
7.     // chineseParam将会是乱码
8.     System.out.println(chineseParam); // 输出可能是"???"
9. }

复制代码

2. GET请求参数乱码

GET请求的参数通常包含在URL中，如果URL中包含中文字符且未正确处理，也会导致乱码。

2. // 示例：GET请求参数乱码
3. protected void doGet(HttpServletRequest request, HttpServletResponse response)
4.     throws ServletException, IOException {
5.     String chineseParam = request.getParameter("chineseParam");
6.     // URL中的中文参数可能被浏览器编码，服务器解析不当会导致乱码
7.     System.out.println(chineseParam); // 输出可能是"???"
8. }

复制代码

3. 响应输出乱码

当Servlet向客户端输出中文字符时，如果未正确设置响应编码，浏览器可能会显示乱码或问号。

2. // 示例：响应输出乱码
3. protected void doGet(HttpServletRequest request, HttpServletResponse response)
4.     throws ServletException, IOException {
5.     PrintWriter out = response.getWriter();
6.     out.println("中文内容"); // 如果未设置正确的响应编码，浏览器可能显示乱码
7. }

复制代码

4. 数据库存储乱码

当将中文字符存入数据库或从数据库读取中文字符时，如果数据库连接或数据库本身的编码设置不正确，也会导致乱码。

2. // 示例：数据库存储乱码
3. public void saveChineseData(String chineseData) {
4.     try {
5.         Connection conn = dataSource.getConnection();
6.         String sql = "INSERT INTO my_table (chinese_column) VALUES (?)";
7.         PreparedStatement stmt = conn.prepareStatement(sql);
8.         stmt.setString(1, chineseData); // 如果数据库连接未使用正确的编码，存储的数据可能是乱码
9.         stmt.executeUpdate();
10.     } catch (SQLException e) {
11.         e.printStackTrace();
12.     }
13. }

复制代码

解决方案

针对上述乱码场景，我们可以采取以下解决方案：

请求乱码解决方案

对于POST请求，应在读取请求参数之前设置请求编码：

2. protected void doPost(HttpServletRequest request, HttpServletResponse response)
3.     throws ServletException, IOException {
4.     // 设置请求编码，必须在使用request.getParameter()之前调用
5.     request.setCharacterEncoding("UTF-8");
6.    
7.     String chineseParam = request.getParameter("chineseParam");
8.     System.out.println(chineseParam); // 现在应该能正确显示中文
9. }

复制代码

GET请求参数乱码的解决方法因服务器而异：

方法1：修改服务器配置

对于Tomcat服务器，可以修改server.xml文件，在Connector元素中添加URIEncoding属性：

2. <Connector port="8080" protocol="HTTP/1.1"
3.            connectionTimeout="20000"
4.            redirectPort="8443"
5.            URIEncoding="UTF-8" />

复制代码

方法2：手动编码转换

如果无法修改服务器配置，可以在代码中手动转换编码：

2. protected void doGet(HttpServletRequest request, HttpServletResponse response)
3.     throws ServletException, IOException {
4.     String chineseParam = request.getParameter("chineseParam");
5.    
6.     // 手动转换编码
7.     if (chineseParam != null) {
8.         // 假设原始请求是ISO-8859-1编码，转换为UTF-8
9.         chineseParam = new String(chineseParam.getBytes("ISO-8859-1"), "UTF-8");
10.     }
11.    
12.     System.out.println(chineseParam); // 现在应该能正确显示中文
13. }

复制代码

方法3：使用URL编码/解码

在生成包含中文参数的URL时，使用URLEncoder进行编码：

2. // 生成URL时编码参数
3. String chineseParam = "中文参数";
4. String encodedParam = URLEncoder.encode(chineseParam, "UTF-8");
5. String url = "http://example.com/servlet?param=" + encodedParam;

复制代码

在Servlet中，服务器通常会自动解码URL参数，但确保服务器配置正确（如上述方法1）。

响应乱码解决方案

在向客户端输出内容之前，应正确设置响应编码：

2. protected void doGet(HttpServletRequest request, HttpServletResponse response)
3.     throws ServletException, IOException {
4.     // 设置响应内容的类型和编码
5.     response.setContentType("text/html;charset=UTF-8");
6.     // 或者分别设置
7.     // response.setContentType("text/html");
8.     // response.setCharacterEncoding("UTF-8");
9.    
10.     PrintWriter out = response.getWriter();
11.     out.println("中文内容"); // 现在浏览器应该能正确显示中文
12. }

复制代码

在生成的HTML页面中，也应指定字符编码：

2. protected void doGet(HttpServletRequest request, HttpServletResponse response)
3.     throws ServletException, IOException {
4.     response.setContentType("text/html;charset=UTF-8");
5.     PrintWriter out = response.getWriter();
6.    
7.     out.println("<!DOCTYPE html>");
8.     out.println("<html>");
9.     out.println("<head>");
10.     out.println("<meta charset="UTF-8">"); // 指定HTML页面编码
11.     out.println("<title>中文页面</title>");
12.     out.println("</head>");
13.     out.println("<body>");
14.     out.println("<p>这是中文内容</p>");
15.     out.println("</body>");
16.     out.println("</html>");
17. }

复制代码

数据库乱码解决方案

在连接数据库时，应在连接URL中指定字符编码：

2. // MySQL数据库连接URL示例
3. String url = "jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8";
4. Connection conn = DriverManager.getConnection(url, username, password);

复制代码

创建数据库表时，应指定字符集：

2. -- MySQL示例
3. CREATE TABLE my_table (
4.     id INT PRIMARY KEY,
5.     chinese_column VARCHAR(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
6. ) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

复制代码

确保数据库服务器本身配置了正确的字符集。例如，对于MySQL，可以修改my.cnf（或my.ini）文件：

2. [mysqld]
3. character-set-server=utf8mb4
4. collation-server=utf8mb4_unicode_ci

复制代码

URL乱码解决方案

在处理包含中文的URL时，应使用正确的编码方法：

2. // 编码URL参数
3. String paramValue = "中文值";
4. String encodedValue = URLEncoder.encode(paramValue, "UTF-8");
5. String url = "http://example.com/servlet?param=" + encodedValue;
7. // 解码URL参数
8. String decodedValue = URLDecoder.decode(encodedValue, "UTF-8");

复制代码

为了在整个Web应用中统一处理编码问题，可以创建一个过滤器：

2. @WebFilter("/*")
3. public class EncodingFilter implements Filter {
4.    
5.     private String encoding = "UTF-8";
6.    
7.     @Override
8.     public void init(FilterConfig filterConfig) throws ServletException {
9.         // 可以从web.xml中读取编码配置
10.         String encodingParam = filterConfig.getInitParameter("encoding");
11.         if (encodingParam != null) {
12.             encoding = encodingParam;
13.         }
14.     }
15.    
16.     @Override
17.     public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
18.             throws IOException, ServletException {
19.         // 设置请求编码
20.         request.setCharacterEncoding(encoding);
21.         
22.         // 设置响应编码
23.         response.setContentType("text/html;charset=" + encoding);
24.         response.setCharacterEncoding(encoding);
25.         
26.         // 继续处理请求
27.         chain.doFilter(request, response);
28.     }
29.    
30.     @Override
31.     public void destroy() {
32.         // 清理资源
33.     }
34. }

复制代码

然后在web.xml中配置过滤器：

2. <filter>
3.     <filter-name>EncodingFilter</filter-name>
4.     <filter-class>com.example.EncodingFilter</filter-class>
5.     <init-param>
6.         <param-name>encoding</param-name>
7.         <param-value>UTF-8</param-value>
8.     </init-param>
9. </filter>
10. <filter-mapping>
11.     <filter-name>EncodingFilter</filter-name>
12.     <url-pattern>/*</url-pattern>
13. </filter-mapping>

复制代码

最佳实践

为了有效避免Servlet中的中文乱码问题，以下是一些最佳实践建议：

1. 统一使用UTF-8编码

在整个应用程序中统一使用UTF-8编码，包括：

• 所有源代码文件保存为UTF-8格式
• 所有JSP文件使用UTF-8编码
• 所有HTML页面指定UTF-8编码
• 数据库连接、表和字段使用UTF-8编码（或UTF-8MB4以支持更多字符）

2. 使用过滤器处理编码

如上所述，使用过滤器统一处理请求和响应的编码问题，避免在每个Servlet中重复设置编码。

3. 明确指定所有编码相关参数

不要依赖系统默认编码，明确指定所有与编码相关的参数：

2. // 不好的做法：依赖默认编码
3. String str = "中文";
4. byte[] bytes = str.getBytes(); // 使用系统默认编码
6. // 好的做法：明确指定编码
7. String str = "中文";
8. byte[] bytes = str.getBytes("UTF-8"); // 明确指定UTF-8编码

复制代码

4. 处理文件上传时的编码

当处理包含中文字符的文件上传时，也需要注意编码问题：

2. // 使用Apache Commons FileUpload处理文件上传
3. DiskFileItemFactory factory = new DiskFileItemFactory();
4. ServletFileUpload upload = new ServletFileUpload(factory);
5. upload.setHeaderEncoding("UTF-8"); // 设置请求头编码
7. List<FileItem> items = upload.parseRequest(request);
8. for (FileItem item : items) {
9.     if (item.isFormField()) {
10.         // 处理普通表单字段
11.         String fieldName = item.getFieldName();
12.         String value = item.getString("UTF-8"); // 指定编码获取字段值
13.         // ...
14.     } else {
15.         // 处理上传文件
16.         String fileName = item.getName();
17.         // ...
18.     }
19. }

复制代码

5. 使用现代Web框架

现代Web框架（如Spring MVC）通常提供了更好的编码处理机制：

2. // Spring MVC示例
3. @Controller
4. public class MyController {
5.    
6.     // 通过配置或注解自动处理编码问题
7.     @RequestMapping(value = "/submit", method = RequestMethod.POST, produces = "text/html;charset=UTF-8")
8.     @ResponseBody
9.     public String handleSubmit(@RequestParam("chineseParam") String chineseParam) {
10.         // Spring MVC已自动处理请求编码，无需手动设置
11.         return "接收到的中文参数：" + chineseParam;
12.     }
13. }

复制代码

6. 日志和调试

在开发过程中，添加日志记录以帮助调试编码问题：

2. protected void doPost(HttpServletRequest request, HttpServletResponse response)
3.     throws ServletException, IOException {
4.     // 设置请求编码
5.     request.setCharacterEncoding("UTF-8");
6.    
7.     String chineseParam = request.getParameter("chineseParam");
8.    
9.     // 记录原始参数值和字节表示，便于调试
10.     if (chineseParam != null) {
11.         System.out.println("参数值: " + chineseParam);
12.         System.out.println("参数字节(UTF-8): " + Arrays.toString(chineseParam.getBytes("UTF-8")));
13.         System.out.println("参数字节(ISO-8859-1): " + Arrays.toString(chineseParam.getBytes("ISO-8859-1")));
14.     }
15.    
16.     // 处理请求...
17. }

复制代码

实际案例

通过一个完整的示例，展示如何解决Servlet中的中文乱码问题。

1. 创建编码过滤器

2. package com.example.filter;
4. import javax.servlet.*;
5. import javax.servlet.annotation.WebFilter;
6. import java.io.IOException;
8. @WebFilter("/*")
9. public class CharacterEncodingFilter implements Filter {
10.    
11.     private String encoding = "UTF-8";
12.    
13.     @Override
14.     public void init(FilterConfig filterConfig) throws ServletException {
15.         String encodingParam = filterConfig.getInitParameter("encoding");
16.         if (encodingParam != null) {
17.             encoding = encodingParam;
18.         }
19.     }
20.    
21.     @Override
22.     public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
23.             throws IOException, ServletException {
24.         request.setCharacterEncoding(encoding);
25.         response.setContentType("text/html;charset=" + encoding);
26.         response.setCharacterEncoding(encoding);
27.         
28.         chain.doFilter(request, response);
29.     }
30.    
31.     @Override
32.     public void destroy() {
33.         // 清理资源
34.     }
35. }

复制代码

2. 创建处理中文的Servlet

2. package com.example.servlet;
4. import javax.servlet.ServletException;
5. import javax.servlet.annotation.WebServlet;
6. import javax.servlet.http.HttpServlet;
7. import javax.servlet.http.HttpServletRequest;
8. import javax.servlet.http.HttpServletResponse;
9. import java.io.IOException;
10. import java.io.PrintWriter;
11. import java.sql.*;
13. @WebServlet("/chinese")
14. public class ChineseServlet extends HttpServlet {
15.    
16.     private static final String DB_URL = "jdbc:mysql://localhost:3306/testdb?useUnicode=true&characterEncoding=UTF-8";
17.     private static final String DB_USER = "username";
18.     private static final String DB_PASSWORD = "password";
19.    
20.     @Override
21.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
22.             throws ServletException, IOException {
23.         // 过滤器已设置编码，这里无需重复设置
24.         
25.         String action = request.getParameter("action");
26.         String chineseText = request.getParameter("text");
27.         
28.         response.setContentType("text/html;charset=UTF-8");
29.         PrintWriter out = response.getWriter();
30.         
31.         out.println("<!DOCTYPE html>");
32.         out.println("<html>");
33.         out.println("<head>");
34.         out.println("<meta charset="UTF-8">");
35.         out.println("<title>中文处理示例</title>");
36.         out.println("</head>");
37.         out.println("<body>");
38.         
39.         if ("save".equals(action) && chineseText != null && !chineseText.isEmpty()) {
40.             // 保存中文到数据库
41.             saveToDatabase(chineseText);
42.             out.println("<p>已保存到数据库: " + chineseText + "</p>");
43.         } else if ("load".equals(action)) {
44.             // 从数据库加载中文
45.             String loadedText = loadFromDatabase();
46.             out.println("<p>从数据库加载: " + (loadedText != null ? loadedText : "无数据") + "</p>");
47.         }
48.         
49.         // 显示表单
50.         out.println("<form method="post" action="chinese?action=save">");
51.         out.println("<label for="text">输入中文:</label>");
52.         out.println("<input type="text" id="text" name="text" value="">");
53.         out.println("<input type="submit" value="保存">");
54.         out.println("</form>");
55.         
56.         out.println("<a href="chinese?action=load">从数据库加载</a>");
57.         
58.         out.println("</body>");
59.         out.println("</html>");
60.     }
61.    
62.     @Override
63.     protected void doPost(HttpServletRequest request, HttpServletResponse response)
64.             throws ServletException, IOException {
65.         doGet(request, response);
66.     }
67.    
68.     private void saveToDatabase(String chineseText) {
69.         try (Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASSWORD);
70.              PreparedStatement stmt = conn.prepareStatement("INSERT INTO chinese_texts (text) VALUES (?)")) {
71.             
72.             stmt.setString(1, chineseText);
73.             stmt.executeUpdate();
74.             
75.         } catch (SQLException e) {
76.             e.printStackTrace();
77.         }
78.     }
79.    
80.     private String loadFromDatabase() {
81.         try (Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASSWORD);
82.              Statement stmt = conn.createStatement();
83.              ResultSet rs = stmt.executeQuery("SELECT text FROM chinese_texts ORDER BY id DESC LIMIT 1")) {
84.             
85.             if (rs.next()) {
86.                 return rs.getString("text");
87.             }
88.             
89.         } catch (SQLException e) {
90.             e.printStackTrace();
91.         }
92.         
93.         return null;
94.     }
95. }

复制代码

3. 创建数据库表

2. CREATE DATABASE testdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
4. USE testdb;
6. CREATE TABLE chinese_texts (
7.     id INT AUTO_INCREMENT PRIMARY KEY,
8.     text VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci,
9.     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
10. ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

复制代码

4. 配置web.xml

2. <?xml version="1.0" encoding="UTF-8"?>
3. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
4.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5.          xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
6.                              http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
7.          version="4.0">
8.    
9.     <filter>
10.         <filter-name>CharacterEncodingFilter</filter-name>
11.         <filter-class>com.example.filter.CharacterEncodingFilter</filter-class>
12.         <init-param>
13.             <param-name>encoding</param-name>
14.             <param-value>UTF-8</param-value>
15.         </init-param>
16.     </filter>
17.    
18.     <filter-mapping>
19.         <filter-name>CharacterEncodingFilter</filter-name>
20.         <url-pattern>/*</url-pattern>
21.     </filter-mapping>
22.    
23. </web-app>

复制代码

5. 配置Tomcat服务器

修改Tomcat的server.xml文件，确保Connector元素包含URIEncoding属性：

2. <Connector port="8080" protocol="HTTP/1.1"
3.            connectionTimeout="20000"
4.            redirectPort="8443"
5.            URIEncoding="UTF-8" />

复制代码

这个完整的示例展示了如何通过过滤器、正确的数据库配置、服务器设置以及Servlet中的编码处理，来全面解决中文乱码问题。

总结与建议

Servlet中的中文乱码问题是一个常见但棘手的问题，涉及多个层面的编码设置。通过本文的分析，我们可以得出以下结论和建议：

关键要点

1. 编码一致性：确保整个应用程序链中的编码设置一致，从前端页面到后端处理，再到数据库存储，都应使用相同的编码（推荐UTF-8）。
2. 请求处理：对于POST请求，在使用request.getParameter()之前调用request.setCharacterEncoding()；对于GET请求，通过服务器配置或手动编码转换解决。
3. 响应处理：在输出内容之前，设置正确的响应编码，推荐使用response.setContentType("text/html;charset=UTF-8")。
4. 数据库处理：在数据库连接URL中指定字符编码，并确保数据库表和字段使用正确的字符集。
5. 统一管理：使用过滤器统一管理请求和响应的编码，避免在每个Servlet中重复设置。

编码一致性：确保整个应用程序链中的编码设置一致，从前端页面到后端处理，再到数据库存储，都应使用相同的编码（推荐UTF-8）。

请求处理：对于POST请求，在使用request.getParameter()之前调用request.setCharacterEncoding()；对于GET请求，通过服务器配置或手动编码转换解决。

响应处理：在输出内容之前，设置正确的响应编码，推荐使用response.setContentType("text/html;charset=UTF-8")。

数据库处理：在数据库连接URL中指定字符编码，并确保数据库表和字段使用正确的字符集。

统一管理：使用过滤器统一管理请求和响应的编码，避免在每个Servlet中重复设置。

常见错误排查

当遇到中文乱码问题时，可以按照以下步骤进行排查：

1. 检查浏览器编码：确认浏览器是否使用了正确的编码解析页面。
2. 检查请求编码：确认请求参数是否使用了正确的编码发送和接收。
3. 检查响应编码：确认响应内容是否使用了正确的编码生成。
4. 检查数据库编码：确认数据库连接、表和字段是否使用了正确的编码。
5. 检查服务器配置：确认服务器（如Tomcat）是否配置了正确的URL编码。

检查浏览器编码：确认浏览器是否使用了正确的编码解析页面。

检查请求编码：确认请求参数是否使用了正确的编码发送和接收。

检查响应编码：确认响应内容是否使用了正确的编码生成。

检查数据库编码：确认数据库连接、表和字段是否使用了正确的编码。

检查服务器配置：确认服务器（如Tomcat）是否配置了正确的URL编码。

未来趋势

随着Java Web技术的发展，现代框架（如Spring Boot）已经大大简化了编码问题的处理。这些框架通常默认使用UTF-8编码，并提供了自动化的编码处理机制。然而，理解底层原理仍然非常重要，特别是在处理遗留系统或遇到特殊编码需求时。

最终建议

1. 始终明确指定编码：不要依赖系统默认编码，始终明确指定所有与编码相关的参数。
2. 使用过滤器：实现并使用编码过滤器，统一管理整个Web应用的编码问题。
3. 测试各种场景：测试表单提交、URL参数、文件上传等各种场景下的中文处理。
4. 记录日志：在开发过程中添加适当的日志记录，便于调试编码问题。
5. 保持更新：关注最新的开发实践和框架更新，利用新技术简化编码问题的处理。

始终明确指定编码：不要依赖系统默认编码，始终明确指定所有与编码相关的参数。

使用过滤器：实现并使用编码过滤器，统一管理整个Web应用的编码问题。

测试各种场景：测试表单提交、URL参数、文件上传等各种场景下的中文处理。

记录日志：在开发过程中添加适当的日志记录，便于调试编码问题。

保持更新：关注最新的开发实践和框架更新，利用新技术简化编码问题的处理。

通过系统性地理解和应用本文提供的解决方案与实践技巧，开发者可以有效解决Servlet中的中文乱码问题，提高Web应用的国际化和用户体验。