NoSuchMethodError: org.apache.tomcat.util.codec.binary.Base64.encodeBase64问题修复

问题描述

在将 Tomcat 从 8.5 升级到 9 后，遇到 NoSuchMethodError: org.apache.tomcat.util.codec.binary.Base64.encodeBase64 错误

问题分析

Tomcat 9 引入了一些 API 的变更，特别是在 org.apache.tomcat.util.codec.binary.Base64 类中。此类中的某些方法可能已被删除、替换或重命名。因此，如果你的应用程序或依赖的库（比如旧版本的第三方库）仍然使用旧的 Base64 编码方法，就会出现 NoSuchMethodError。

解决方案

1. 更新依赖库：

   • 检查你项目中所有依赖项，确保它们都兼容 Tomcat 9。特别是关注那些使用 Apache Commons Codec 的库。
   • 如果有必要，更新这些库到最新版本，以确保它们可以正常工作。

2. 排除冲突的库：

   • 在 Maven 项目中，可以通过添加

     <exclusions>
     

     来排除不必要的依赖。例如：

     xml复制代码<dependency>
         <groupId>your.group</groupId>
         <artifactId>your-artifact</artifactId>
         <version>your-version</version>
         <exclusions>
             <exclusion>
                 <groupId>commons-codec</groupId>
                 <artifactId>commons-codec</artifactId>
             </exclusion>
         </exclusions>
     </dependency>
     

3. 使用 Java 自带的 Base64：

   • 如果你的应用只需要基本的 Base64 编码功能，可以考虑使用 Java 8 及以上版本自带的

     java.util.Base64
     

     类，而不是依赖于 Tomcat 或 Apache Commons Codec：

     java复制代码import java.util.Base64;
     
     // 编码
     byte[] encodedBytes = Base64.getEncoder().encode("yourString".getBytes());
     String encodedString = new String(encodedBytes);
     
     // 解码
     byte[] decodedBytes = Base64.getDecoder().decode(encodedString);
     String decodedString = new String(decodedBytes);
     

4. 检查 Tomcat 的 lib 文件夹：

   • 确保在 Tomcat 的 lib 文件夹中没有过时的 JAR 包，尤其是与 Apache Commons Codec 相关的 JAR。Tomcat 9 应该使用其内部的工具类，而不是外部的版本。

5. 清理和重新部署：

   • 清理并重新构建项目，删除 Tomcat 中的旧 WAR 文件，并确保从新编译的文件部署到 Tomcat 中。

6. 查看 Tomcat 的日志：

   • 仔细检查 Tomcat 的日志文件 (catalina.out 或其他日志文件)，以获取更多关于错误的信息，这可能有助于确定引发问题的具体原因。

更新文档

关于 Tomcat 9 的具体更新和变更内容，你可以查看以下资源：

• Tomcat 9 发布说明：
  • Apache Tomcat 9 Change Log
• Tomcat 9 API 文档：
  • Apache Tomcat 9 API Documentation

在 Change Log 中，可以找到与版本相关的所有更新和变动信息，包括弃用的方法和类的详细说明。

在API 中 Package org.apache.tomcat.util.codec.binary 已经废弃了Base64这一方法

使用 Java 自带的 Base64 示例

如果你打算迁移到 Java 的标准库，以下是如何使用 java.util.Base64 的示例：

java复制代码import java.util.Base64;

public class Base64Example {
    public static void main(String[] args) {
        String originalInput = "Hello, World!";
        
        // 编码
        String encodedString = Base64.getEncoder().encodeToString(originalInput.getBytes());
        System.out.println("Encoded: " + encodedString);

        // 解码
        byte[] decodedBytes = Base64.getDecoder().decode(encodedString);
        String decodedString = new String(decodedBytes);
        System.out.println("Decoded: " + decodedString);
    }
}