Java Base64解码错误及解决方法

背景

Base64是一种将二进制数据编码成ASCII字符可读格式的编码方式，常用于网络传输、数据存储等场景。Java提供了丰富的Base64编解码类库，如java.util.Base64或apache.commons.codec.binary.Base64等。

但在实际应用中，我们可能会遇到Base64解码错误的问题，本篇攻略主要针对Base64解码错误及解决方法进行说明。

方案

Base64解码错误可能由多种原因引起，下面列举几种常见问题及解决方案。

问题1：Base64字符串长度不合法

Base64字符串长度应该是4的倍数，否则会抛出java.lang.IllegalArgumentException: Length must be a multiple of 4异常。

下面是一个错误示例：

import java.util.Base64;
public class Test{
    public static void main(String[] args){
        String base64String = "YWJjZA"; // 长度为7的字符串，不是4的倍数
        byte[] bytes = Base64.getDecoder().decode(base64String);
    }
}

解决方案：检查Base64字符串是否正确，应该保证长度是4的倍数。

import java.util.Base64;
public class Test{
    public static void main(String[] args){
        String base64String = "YWJjZA=="; // 长度为8的字符串，是4的倍数
        byte[] bytes = Base64.getDecoder().decode(base64String);
    }
}

问题2：Base64字符串包含非法字符

Base64字符串只允许包含A~Z、a~z、0~9、+、/、=这些字符，否则会抛出java.lang.IllegalArgumentException: Illegal base64 character [char]异常。

下面是一个错误示例：

import java.util.Base64;
public class Test{
    public static void main(String[] args){
        String base64String = "YWJjZ&=="; // 包含非法字符&
        byte[] bytes = Base64.getDecoder().decode(base64String);
    }
}

解决方案：检查Base64字符串是否正确，应该只包含A~Z、a~z、0~9、+、/、=这些字符。

import java.util.Base64;
public class Test{
    public static void main(String[] args){
        String base64String = "YWJjZA=="; // 只包含合法字符
        byte[] bytes = Base64.getDecoder().decode(base64String);
    }
}

示例

下面是一个完整的示例，将一个字符串进行Base64编码后再解码。

import java.util.Base64;
public class Test{
    public static void main(String[] args){
        String originStr = "Hello,world!"; // 原始字符串
        String base64Str = Base64.getEncoder().encodeToString(originStr.getBytes()); // Base64编码后的字符串
        System.out.println("Base64 string: "+base64Str);
        byte[] bytes = Base64.getDecoder().decode(base64Str); // Base64解码后的字节数组
        String resultStr = new String(bytes); // 解码后的字符串
        System.out.println("Result string: "+resultStr);
    }
}

运行结果：

Base64 string: SGVsbG8sd29ybGQh
Result string: Hello,world!

结论

在使用Java进行Base64编解码时，应注意字符串长度和字符合法性等问题，避免出现解码错误。使用标准的Base64编解码类库可以有效避免这些问题，如java.util.Base64或apache.commons.codec.binary.Base64等。