如何解决Ubuntu上JSP的乱码问题

Ubuntu上JSP乱码的定位与解决

一、常见成因与排查顺序

• 全链路字符集不统一：JSP源文件保存编码、HTTP响应头、Tomcat连接器、数据库连接、Linux系统环境、浏览器显示不一致都会引发乱码。优先统一为UTF-8。
• 请求参数解码不一致：GET 参数默认按 ISO-8859-1 解码；POST 参数需在过滤器中显式设置为 UTF-8。
• 数据库字符集与连接参数不匹配：库/表/连接未统一为 UTF-8/utf8mb4 会出现入库或读出乱码。
• 文件本身不是UTF-8：在Ubuntu下用编辑器或命令行确认并转换为UTF-8。
• 浏览器未按UTF-8渲染：检查响应头与页面meta是否一致。

二、JSP与Web层设置

• 在JSP顶部统一声明：

  <%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
  

• 在HTML中声明：

  <meta charset="UTF-8">
  

• 在Servlet或过滤器中设置请求/响应编码：

  request.setCharacterEncoding("UTF-8");
  response.setContentType("text/html;charset=UTF-8");
  response.setCharacterEncoding("UTF-8");
  

• 表单提交建议显式声明：

  <form accept-charset="UTF-8">
  

• 建议引入字符编码过滤器（对所有请求统一设置request编码为UTF-8）。

三、Tomcat与操作系统层设置

• Tomcat连接器（server.xml）：
  • 统一使用UTF-8（推荐）：

    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000" redirectPort="8443"
               URIEncoding="UTF-8" />
    

  • 若历史系统依赖GET按GBK解码，可改为：

    <Connector ... URIEncoding="GBK" />
    

  • 或使用请求体编码策略：

    <Connector ... useBodyEncodingForURI="true" />
    

  修改后需重启Tomcat。
• Ubuntu系统环境：
  • 检查并设置系统默认语言环境为UTF-8（如检查/设置 locale，确保 LANG/LC_CTYPE 等为 zh_CN.UTF-8 或 en_US.UTF-8）。
  • 注意：Linux环境下不建议安装/启用GBK环境，避免与UTF-8混用。

四、数据库与JDBC设置（以MySQL为例）

• 数据库/表/列字符集：
  • 建议创建库表使用：

    CREATE DATABASE your_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    

• JDBC连接串显式指定UTF-8：

  jdbc:mysql://localhost:3306/your_db?useUnicode=true&characterEncoding=UTF-8
  

• 服务器端配置（my.cnf，确保客户端/服务端/连接统一）：

  [client]
  default-character-set=utf8
  
  [mysqld_safe]
  default-character-set=utf8
  
  [mysqld]
  default-character-set=utf8
  
  [mysql]
  default-character-set=utf8
  

• 验证：登录MySQL执行

  SHOW VARIABLES LIKE '%char%';
  

  确认关键变量为 utf8/utf8mb4。

五、快速自检与常见坑

• 自检清单：
  • 响应头是否包含：Content-Type: text/html; charset=UTF-8。
  • JSP是否同时设置：contentType 与 pageEncoding 为 UTF-8。
  • 表单是否使用：accept-charset=“UTF-8”。
  • Tomcat的 server.xml 是否设置 URIEncoding（GET参数依赖此项）。
  • JDBC URL是否带：characterEncoding=UTF-8。
  • 数据库/表是否为 utf8/utf8mb4。
  • 源文件是否以 UTF-8 保存（编辑器或命令行确认）。
  • 浏览器是否按 UTF-8 渲染（查看页面编码设置）。
• 常见坑：
  • 仅设置HTML meta而不设置JSP/响应头，或反之，导致浏览器与服务器编码不一致。
  • 只处理了POST而忽略GET（GET需依赖Tomcat的URIEncoding或useBodyEncodingForURI）。
  • 文件在Windows下编辑为GBK后上传到Ubuntu未转UTF-8。
  • 数据库/连接/表字符集不一致（如库utf8mb4，连接却用latin1）。