Spring Boot TEST环境请求参数未正确解码'+'字符问题

该问题仅在单环境部分实例出现，基本可以排除框架通用逻辑bug，优先排查环境间配置、部署链路的差异，常见原因如下：

• 入口层网关/反向代理配置差异
  这是这类单环境参数解码异常的最高频原因。TEST环境的Nginx、K8s Ingress、API网关、WAF层大概率存在和其他环境不一致的配置：比如配置了错误的rewrite重写规则，对查询参数做了不规范的二次编码——正常流程下入口层收到search=username%2B的请求会直接透传给后端，或者一次解码后再转发；如果TEST环境的代理规则错误对特殊字符做了转义，会把原始的%2B转成%252B传给后端，Spring Boot做一次URL解码后就会拿到字面量%2B，和描述的现象完全一致。重点排查TEST环境独有的路由规则、WAF特殊字符拦截/转义策略。
• 内置容器解码配置不一致
  如果TEST环境通过配置中心、环境变量单独修改了Spring Boot内置Tomcat/Undertow的解码配置，比如没有和其他环境保持一致将URIEncoding设为UTF-8，或者错误开启了非默认值的useBodyEncodingForURI、decode-url参数，会导致查询参数解码逻辑异常。因为是环境专属配置，所以只会在TEST环境复现。
• 应用层存在环境独有的参数篡改逻辑
  排查TEST环境是否加载了DEV/PROD没有的Servlet过滤器、拦截器、AOP切面：比如为了压测、调试、签名校验加的参数处理逻辑，错误调用了URLEncoder.encode()对查询参数做了重复编码。可以直接在Controller入口打印原始query string，对比网关转发的原始报文，快速定位是不是应用内部逻辑篡改了参数。
• 部署版本不一致
  问题仅出现在部分实例时，优先核对出问题实例的构建版本：是否存在旧版本实例没被正确滚动更新、发布时部分实例拉取了错误的依赖包（比如存在解码bug的低版本spring-web、内嵌Tomcat包）、部分实例启动时没有拉取到正确的配置中心配置，导致解码逻辑和正常实例不一致。
• 参数解析器配置差异
  检查TEST环境是否配置了自定义的Spring MVC参数转换器、参数解析器，且这个配置只在TEST环境的配置分支生效——比如自定义的Converter对字符串参数做了多余的转义处理，导致拿到的参数没有被正确解码。

快速排查路径：从请求入口开始逐层抓包/打日志，依次核对「浏览器原始发出的请求」「网关层收到的请求」「网关转发给后端的请求」「应用过滤器拿到的原始请求」「Controller层接收到的解析后参数」，在哪一层出现了%2B到%252B的变化，问题点就在哪一层。

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