spring mvc 中 characterencodingfilter 必须在 web.xml 中配置为 servlet 容器级过滤器，因其依赖 servlet 生命周期初始化，需置于 和 之前，映射路径为 /*，并设 encoding="utf-8" 和 forceencoding=true（或新版本的 forcerequestencoding=true 与 forceresponseencoding=true）以强制统一请求与响应编码。
Spring MVC 中通过 CharacterEncodingFilter 在容器初始化时统一解决中文乱码，关键在于把它配置成 Servlet 容器级的过滤器，并确保它在所有请求进入 Spring MVC 之前就生效。这个过滤器不是 Spring MVC 自身的拦截器，而是基于 Servlet 规范的 javax.servlet.Filter，因此天然具备“容器启动即加载、请求入口即拦截”的能力。
为什么必须在 web.xml 中配置（传统 Spring MVC）
该过滤器依赖 Servlet 容器生命周期，在 ServletContext 初始化阶段由容器调用 init() 方法完成配置。它不属于 Spring 上下文管理的 Bean，不走 ApplicationContext 加载流程，所以不能靠 @Bean 或 XML 中的 <bean></bean> 声明——必须写在 web.xml 的 <filter></filter> 段里，才能被容器识别并提前注册。
-
位置要靠前：在
web.xml中，<filter></filter>声明应置于<servlet></servlet>和<listener></listener>之前，确保它最先被加载 -
映射路径要全覆盖：使用
<url-pattern>/*</url-pattern>，而非/或空值，否则静态资源或某些路径可能绕过过滤 -
不能漏掉 filter-mapping：只有声明了
<filter-mapping></filter-mapping>，容器才知道该把哪些请求交给它处理
核心参数 encoding 和 forceEncoding 的作用
encoding 指定目标编码（如 UTF-8），而 forceEncoding 决定是否强制覆盖已有编码设置——这是防乱码的关键开关。
-
encoding=UTf-8：设为项目实际采用的编码，建议全站统一用 UTF-8 -
forceEncoding=true：强制对 request 和 response 都应用该编码，无视客户端或容器默认设置；若为 false，当 request 已有编码（如 Tomcat 对 GET 参数默认用 ISO-8859-1）时，过滤器会跳过设置，导致 POST 正常、GET 仍乱码 - 注意：老版本 Spring（如 4.x）用的是
forceEncoding；新版本（5.2+）拆分为forceRequestEncoding和forceResponseEncoding，建议显式设两者为 true
GET 请求乱码的特殊处理
CharacterEncodingFilter 默认只对 POST 请求体（request.getInputStream()）生效，对 URL 中的 GET 参数无效——因为 Tomcat 在解析 URL 时已按自身默认编码（通常是 ISO-8859-1）完成解码，此时 request 的 queryString 已是错误字节序列。
- 解决方案一：改 Tomcat 配置，在
server.xml的<connector></connector>中添加URIEncoding="UTF-8" - 解决方案二：自定义 Filter 继承
OncePerRequestFilter，重写HttpServletRequestWrapper，对getParameter等方法做透明转码（如将 ISO-8859-1 字节再按 UTF-8 解码） - 不推荐手动在每个 Controller 里用
new String(param.getBytes("ISO-8859-1"), "UTF-8")，维护成本高且易遗漏
Spring Boot 用户怎么配
Spring Boot 项目没有 web.xml，需通过 Java Config 注册过滤器 Bean：
- 定义一个
@Bean返回CharacterEncodingFilter实例 - 设置
setEncoding("UTF-8")和setForceRequestEncoding(true)、setForceResponseEncoding(true) - 该 Bean 会被 Spring Boot 的 ServletWebServerFactory 自动注册到容器，等效于
web.xml配置 - 注意：此方式仅适用于内嵌容器（Tomcat/Jetty），且必须确保 Bean 在 WebMvcConfigurer 之前加载
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
