解决 "java.lang.IllegalArgumentException: Last encoded character (before the padding character '=') was not a valid base 64 character" 问题的步骤

概览

在解决 "java.lang.IllegalArgumentException: Last encoded character (before the padding character '=') was not a valid base 64 character" 问题之前，首先需要理解该异常的原因和基本概念。然后，我们可以按照以下步骤来解决问题：

  1. 确定异常的来源和上下文。
  2. 确认是否使用了正确的Base64编码/解码算法。
  3. 检查输入字符的完整性。
  4. 如有必要，调整输入字符以符合Base64编码规则。
  5. 处理解码过程中可能引发的其他异常。

下面我们将详细解释每个步骤以及相应的代码示例。

步骤

1. 确定异常的来源和上下文

首先，我们需要明确异常的来源和上下文。异常消息 "java.lang.IllegalArgumentException: Last encoded character (before the padding character '=') was not a valid base 64 character" 表示在Base64解码过程中，最后一个编码字符（'='字符之前的字符）不是有效的Base64字符。

2. 确认是否使用了正确的Base64编码/解码算法

确保你正在使用Java标准库中的 java.util.Base64 类来进行Base64编码和解码操作。该类提供了 Base64.getDecoder() 方法用于获取Base64解码器。

import java.util.Base64;

Base64.Decoder decoder = Base64.getDecoder();

3. 检查输入字符的完整性

Base64编码要求输入字符的长度必须是4的倍数。如果输入字符的长度不是4的倍数，那么会导致解码过程中出现异常。

在解码过程之前，你可以使用以下代码检查输入字符长度是否正确：

if (encodedString.length() % 4 != 0) {
    // 处理输入字符长度不正确的情况
}

4. 如有必要，调整输入字符以符合Base64编码规则

如果输入字符的长度是4的倍数，但是最后一个编码字符（'='字符之前的字符）仍然不是有效的Base64字符，那么有可能是输入字符被篡改或者截断了。

为了解决这个问题，你可以尝试删除最后一个编码字符以及其后的所有字符，并重新执行解码操作。以下代码演示了如何删除最后一个编码字符：

if (encodedString.length() % 4 == 0 && encodedString.charAt(encodedString.length() - 1) != '=') {
    int lastPaddingIndex = encodedString.lastIndexOf('=');
    encodedString = encodedString.substring(0, lastPaddingIndex);
}

5. 处理解码过程中可能引发的其他异常

在解码过程中，除了 "Last encoded character was not a valid base 64 character" 异常外，还可能出现其他异常，如 "Illegal base64 character" 异常。你需要根据具体情况捕获和处理这些异常。

以下是一个完整的解码过程的示例代码：

import java.util.Base64;

public class Base64DecoderExample {
    public static void main(String[] args) {
        String encodedString = "c3VwZXJfYWJhc2U2NF9rZXk=";

        try {
            Base64.Decoder decoder = Base64.getDecoder();
            
            // 检查输入字符长度
            if (encodedString.length() % 4 != 0) {
                System.out.println("Invalid Base64 encoded string length");
                return;
            }
            
            // 删除最后一个编码字符
            if (encodedString.charAt(encodedString.length() - 1) != '=') {
                int lastPaddingIndex = encodedString.lastIndexOf('=');
                encodedString = encodedString.substring(0, lastPaddingIndex);
            }
            
            // 解码
            byte[] decodedBytes = decoder.decode(encodedString);
            String decodedString = new String(decodedBytes);
            
            System.out.println("Decoded string: " + decodedString);
        } catch (IllegalArgumentException e) {
            System.out.println("Invalid Base64 encoded string: " + encodedString);
            e.printStackTrace();
        }
    }
}

这个示例代码可以处理 "java.lang.IllegalArgumentException: Last encoded character (before the padding character '=') was not a valid base