Java中推荐使用java.util.Base64类进行Base64编码解码,1. 使用Base64.getEncoder().encodeToString()将字符串转为Base64编码;2. 使用Base64.getDecoder().decode()将Base64字符串解码还原;3. 对于URL安全场景,应使用getUrlEncoder()和getUrlDecoder()以避免+、/等特殊字符;4. 注意Base64仅为编码非加密,敏感数据需结合AES等加密算法,且应显式指定UTF-8字符集,大文件宜分块处理。

Java 中实现 Base64 编码和解码有标准方式,推荐使用 JDK 8 及以上版本自带的 java.util.Base64 类。这是官方提供的标准 API,无需引入第三方库,安全且高效。
1. 使用 java.util.Base64 进行编码
Base64 编码可以将字节数组转换为 ASCII 字符串,常用于传输二进制数据(如图片、文件)或在 URL、JSON 中安全传递数据。
- 获取 Base64.Encoder 实例:可通过 Base64.getEncoder() 获取标准编码器
- 调用 encodeToString(byte[]) 方法直接得到字符串结果
示例代码:
String original = "Hello World"; byte[] encodedBytes = Base64.getEncoder().encode(original.getBytes(StandardCharsets.UTF_8)); String encodedString = new String(encodedBytes, StandardCharsets.UTF_8); // 或更简洁: String encoded = Base64.getEncoder().encodeToString(original.getBytes(StandardCharsets.UTF_8)); System.out.println("编码结果: " + encoded); // 输出: SGVsbG8gV29ybGQ=2. 使用 java.util.Base64 进行解码
将 Base64 编码的字符串还原成原始字节数据,再转为原始字符串或其他格式。
立即学习“Java免费学习笔记(深入)”;
- 获取 Base64.Decoder 实例:使用 Base64.getDecoder()
- 调用 decode(String) 方法解析 Base64 字符串
示例代码:
String encoded = "SGVsbG8gV29ybGQ="; byte[] decodedBytes = Base64.getDecoder().decode(encoded); String decoded = new String(decodedBytes, StandardCharsets.UTF_8); System.out.println("解码结果: " + decoded); // 输出: Hello World3. 处理 URL 和文件名安全的 Base64(URL Safe)
某些场景下需要避免 Base64 字符中出现 +、/ 或换行符,比如用在 URL 参数或 JWT 中。
- 使用 Base64.getUrlEncoder() 和 Base64.getUrlDecoder()
- 它们会用 - 和 _ 替代 + 和 /,并省略填充符号(可选)
示例:
String urlSafeOriginal = "Hello+World/加密测试"; String urlSafeEncoded = Base64.getUrlEncoder().encodeToString(urlSafeOriginal.getBytes(StandardCharsets.UTF_8)); System.out.println("URL 安全编码: " + urlSafeEncoded); byte[] urlDecodedBytes = Base64.getUrlDecoder().decode(urlSafeEncoded); String urlDecoded = new String(urlDecodedBytes, StandardCharsets.UTF_8); System.out.println("URL 解码结果: " + urlDecoded);4. 注意事项与最佳实践
虽然 Base64 常被误称为“加密”,但它不是加密算法,只是编码方式,不提供安全性。敏感数据需配合真正加密手段(如 AES)使用。
- 始终指定字符集(推荐 UTF-8),避免平台默认编码差异
- 网络传输或存储前,确认是否需要 URL 安全格式
- 大文件处理时建议分块操作,避免内存溢出
基本上就这些。JDK 自带的 Base64 工具类已经覆盖绝大多数使用场景,简单可靠。不需要额外依赖,也不建议使用过时的 Apache Commons Codec 或内部 sun.misc.BASE64Encoder。标准 API 更清晰,性能更好,维护更有保障。











