JSP输入表单编码错误仅单台Tomcat服务器复现的排查方案咨询

浏览器未拿到响应头明确的charset声明时，会基于操作系统默认编码、页面内容特征自动推断编码，德语变音符号所属的Latin-1字符集和UTF-8存在重叠区间，很容易出现推断错误。浏览器用错误编码对表单内容编码后提交，服务端按预设编码解码就会出现乱码，该问题完全符合你描述的故障特征。

该问题和Tomcat配置高度相关，单服务器环境异常的核心原因通常是节点配置和其他环境不一致，建议逐一排查以下项：

1. 应用层配置 #

• 确认部署的JSP文件头是否正确配置page指令：<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>，排查是否存在打包漏同步、脚本误替换JSP文件的情况
• 检查Struts1全局过滤器、ActionServlet初始化逻辑，是否存在硬编码环境判断的逻辑，导致问题服务器未执行request.setCharacterEncoding("UTF-8")编码设置
• 确认HTML页面是否配置了降级的meta编码声明：<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

2. Tomcat 配置项 #

• 检查conf/server.xml中Http Connector节点配置，确认是否和正常服务器一致设置了URIEncoding="UTF-8"，该配置直接影响GET请求参数的解码逻辑
• 检查conf/web.xml是否配置了Tomcat自带的字符编码过滤器，确认编码参数、过滤规则和正常服务器一致：

<filter>
  <filter-name>CharacterEncodingFilter</filter-name>
  <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
  <init-param>
    <param-name>ignore</param-name>
    <param-value>false</param-value>
  </init-param>
</filter>

• 检查Tomcat启动脚本的JVM启动参数，确认是否配置了-Dfile.encoding=UTF-8，问题服务器如果未配置该参数会继承操作系统默认编码，导致编码异常
• 检查conf/catalina.properties中org.apache.catalina.connector.Response.ignoreContentTypeCharset参数是否被误设为true，该配置会强制移除响应Content-Type头中的charset声明，直接导致你观测到的响应头缺少content-type编码的问题

3. 操作系统层配置 #

• Linux服务器执行locale命令，检查系统默认编码是否为UTF-8；Windows服务器检查系统区域设置的默认编码，操作系统默认编码异常会导致JVM、Tomcat默认编码和其他环境不一致

内容的提问来源于stack exchange，提问作者Stefano Maglione