在Java开发中，页面显示乱码是一个常见且令人困扰的问题，它可能导致用户无法正确理解页面内容，影响系统的可用性和用户体验，乱码问题的产生通常涉及字符编码的不一致，从数据库到前端页面，任何一个环节的编码设置出现偏差，都可能导致最终显示异常，要彻底解决乱码问题，需要系统地排查整个数据流转链路,确保每个环节都使用统一的字符编码。
乱码问题的根源：字符编码不一致
字符编码是将字符集中的字符转换为计算机可以识别的二进制数据的规则，常见的编码包括ISO-8859-1（仅支持英文）、GBK（支持中文）、UTF-8（支持全球多语言字符）等，当数据的编码方式与解码方式不匹配时，就会出现乱码，如果数据以UTF-8格式编码，但页面以ISO-8859-1格式解码，就会出现中文显示为问号或乱码的情况，Java中涉及乱码的常见场景包括：JSP页面编码、Servlet响应编码、数据库连接编码、表单提交编码以及静态资源文件编码等。
JSP页面乱码的解决方案
JSP页面作为前端展示的核心，其编码设置至关重要，需要在JSP页面的顶部使用page指令明确指定编码格式，例如<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>，这条指令中，pageEncoding指定JSP文件本身的编码，而contentType的charset指定浏览器解析页面时使用的编码,两者保持一致可以有效避免JSP页面本身的乱码问题。
对于JSP中包含的静态文本或动态输出，确保所有内容都使用统一的编码，如果JSP页面中包含了其他文件（如通过<%@ include%>指令），被包含的文件也需要使用相同的编码格式，在表单提交时，如果使用method="post"，需要在Servlet中通过request.setCharacterEncoding("UTF-8")设置请求编码，确保POST方式提交的中文参数能够正确解析，需要注意的是，setCharacterEncoding方法必须在request.getParameter()方法之前调用,否则设置无效。
Servlet响应乱码的解决方案
Servlet作为Java Web应用的核心组件，其响应编码的设置直接影响页面的显示效果，在Servlet中，处理GET请求和POST请求的乱码方式有所不同，对于POST请求，除了在doPost方法开头调用request.setCharacterEncoding("UTF-8")外，还需要通过response.setContentType("text/html;charset=UTF-8")设置响应内容的类型和编码，并通过response.setCharacterEncoding("UTF-8")显式指定响应编码，虽然contentType中的charset已经可以指定编码，但显式调用setCharacterEncoding可以确保编码设置的优先级。
对于GET请求，由于参数是通过URL传递的，request.setCharacterEncoding方法无法对其生效，需要对参数进行重新编码处理，可以通过new String(request.getParameter("参数名").getBytes("ISO-8859-1"), "UTF-8")方式将参数从ISO-8859-1编码转换为UTF-8编码，也可以在Tomcat的server.xml配置文件中，为Connector元素添加URIEncoding="UTF-8"属性，统一处理GET请求的编码问题，这种方式更为彻底,无需在每个Servlet中单独处理。
数据库乱码的解决方案
数据库乱码通常是由于数据库连接、数据库表或字段的字符集设置与应用程序编码不一致导致的，需要确保数据库的字符集支持中文，如MySQL中常用的utf8或utf8mb4字符集，在创建数据库和表时，应明确指定字符集，例如CREATE DATABASE db_name CHARACTER SET utf8mb4;和CREATE TABLE table_name (...) CHARACTER SET utf8mb4;，对于涉及中文的字段，如VARCHAR、TEXT等类型,也需要确保字符集正确。
数据库连接URL中需要指定字符集编码，例如MySQL的连接URL可以添加useUnicode=true&characterEncoding=UTF-8参数，确保应用程序与数据库之间的通信使用统一的编码，在执行SQL语句时，如果SQL语句中包含中文硬编码，也需要确保其编码与页面编码一致，通过数据库管理工具（如Navicat）查看数据时，如果出现乱码，可能是工具本身的编码设置问题，需要将其编码设置为UTF-8以匹配数据库字符集。
前端页面与表单提交乱码的解决方案
前端页面中的静态资源（如HTML、CSS、JavaScript文件）也需要确保编码一致，可以在HTML的<head>标签中添加<meta charset="UTF-8">标签，明确指定页面字符集，对于CSS和JavaScript文件，如果中文字符无法正常显示，需要检查文件的编码格式，并将其保存为UTF-8无BOM格式,因为BOM头可能导致某些浏览器解析异常。
表单提交时，如果使用method="get"，参数会附加到URL后面，此时需要确保URL的编码正确，可以通过java.net.URLEncoder类对参数进行编码，例如URLEncoder.encode("中文参数", "UTF-8")，然后在服务器端使用URLDecoder.decode进行解码，对于AJAX请求，需要在请求头中设置Content-Type为application/x-www-form-urlencoded; charset=UTF-8,确保请求参数的编码正确。
其他可能的乱码场景及解决方案
除了上述常见场景，还有一些特殊情况可能导致乱码，文件上传下载时，如果文件名包含中文，可能会出现乱码，需要对文件名进行编码处理，如通过new String(filename.getBytes("ISO-8859-1"), "UTF-8")转换，或者在下载响应头中使用Content-Disposition时对文件名进行URL编码，日志文件中的乱码问题通常是由于日志编码与控制台或文件读取编码不一致导致的，需要确保日志框架（如Log4j、Logback）的输出编码设置为UTF-8。
乱码问题的排查思路
解决Java页面乱码问题需要遵循“统一编码”的原则，从数据产生的源头（数据库）到数据传输的中间环节（Servlet、JSP），再到最终的数据展示（前端页面），确保每个环节都使用相同的字符编码（推荐UTF-8），排查乱码时，可以按照以下步骤进行：首先检查JSP页面的page指令和meta标签编码是否一致；其次检查Servlet中请求和响应的编码设置是否正确；然后检查数据库连接、表字符集以及SQL语句中的编码是否统一；最后检查前端页面和表单提交的编码是否匹配，通过系统性的排查和设置，可以有效避免和解决Java页面乱码问题,提升系统的稳定性和用户体验。
