Tomcat 9 + Java 8升级问题：RequestUtil的URLDecode(String)方法未定义

嗨，这个问题我在帮用户排查Tomcat版本升级时遇到过好几次，咱们从几个关键点来分析和解决：

核心原因：Tomcat 9的API变动与内部类依赖问题 #

org.apache.catalina.util.RequestUtil是Tomcat的内部工具类，这类API在不同Tomcat版本间的兼容性很差——Tomcat 9对这个类的URLDecode方法做了调整：

• 旧版本（比如Tomcat 7/8）可能存在单参数的URLDecode(String)方法，但Tomcat 9中这个方法大概率被移除或重载为需要额外指定字符编码的版本（比如URLDecode(String, String)）
• 另外，直接依赖Tomcat内部类本身就是不推荐的实践，一旦版本升级很容易出问题

分步排查与解决方法 #

1. 验证catalina.jar中的方法签名 #

先确认你的Tomcat 9的catalina.jar里到底有没有单参数的URLDecode方法：

• 打开终端，进入Tomcat的lib目录，执行命令：

  javap -cp catalina.jar org.apache.catalina.util.RequestUtil
  

• 查看输出的方法列表，如果找不到URLDecode(String)，只有URLDecode(String, String)，那就是方法签名变了，直接用单参数调用自然会报错

2. 检查类加载冲突 #

如果jar里确实有这个方法，但还是报错，那大概率是类加载顺序导致加载了旧版本的RequestUtil类：

• 检查你的WAR包的WEB-INF/lib目录，看有没有打包进去旧版本的catalina.jar或者其他Tomcat相关jar（比如tomcat-catalina.jar）
• 如果有，立即删除这些jar包！因为Tomcat容器本身会提供这些类，应用自己打包进去会导致类版本冲突，引发各种奇怪的NoSuchMethodError

3. 推荐的替代方案（彻底解决问题） #

既然RequestUtil是内部类，不如直接改用JDK标准的URL解码方法，彻底摆脱对Tomcat内部API的依赖：
把你的JSP代码第3行替换为：

String fromPage = java.net.URLDecoder.decode("redirect", "UTF-8");

这个方法是JDK标准API，所有Java版本（包括Java 8）都支持，而且不需要依赖任何Tomcat内部类，后续升级Tomcat也不会再出类似问题

总结 #

优先推荐用标准JDK方法替换内部类调用；如果一定要用Tomcat的工具类，要严格匹配对应版本的方法签名，同时绝对不要把Tomcat容器的jar包打包到自己的应用WAR里。

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