Java的Base64类是JDK 8引入的标准编码工具,支持Basic、URL-safe和MIME三种方案,线程安全;编码需先转UTF-8字节数组再encode(),解码后须用相同字符集还原字符串;URL编码用'-'和'_'替代'+','/',MIME每76字符换行;非加密手段,仅用于编码转换。

Java 中的 Base64 类(位于 java.util 包)是 JDK 8 引入的标准编码工具,无需第三方依赖,支持基本(Basic)、URL 安全(URL-safe)和 MIME 三种编码方案,线程安全,使用简单可靠。
Base64 编码:用 encode() 获取字节数组的编码结果
编码操作通过 Base64.getEncoder() 获取编码器实例,调用 encode(byte[]) 返回编码后的字节数组;如需字符串形式,再用 new String(encodedBytes) 或直接用 encodeToString(byte[]) 一步到位。
-
注意:输入必须是原始字节(如 UTF-8 编码后的字符串),不能直接对中文字符串调用 encode —— 先用
"文本".getBytes(StandardCharsets.UTF_8) - 基本编码不换行、不含空格,适合 URL 和文件名场景;MIME 编码每 76 字符加换行符,适合邮件附件
- 示例:
String s = Base64.getEncoder().encodeToString("Hello".getBytes()); // 输出 "SGVsbG8="
Base64 解码:用 decode() 还原原始字节
解码通过 Base64.getDecoder() 获取解码器,调用 decode(String) 或 decode(byte[]) 得到原始字节数组;若原数据是字符串,需按相同字符集(如 UTF-8)构造字符串。
- 解码时若输入含非法字符(如中文、多余空格、长度非 4 倍数),会抛
IllegalArgumentException - URL 安全编码使用 '-' 和 '_' 替代 '+' 和 '/',解码时必须用
Base64.getUrlDecoder(),混用会失败 - 示例:
byte[] bs = Base64.getDecoder().decode("SGVsbG8="); String s = new String(bs, StandardCharsets.UTF_8); // "Hello"
三种编码器的区别与选用场景
JDK 提供三个静态工厂方法,对应不同用途:
立即学习“Java免费学习笔记(深入)”;
-
Base64.getEncoder():标准 Base64,含 '+'、'/' 和 '=',适用于通用存储或内部传输 -
Base64.getUrlEncoder():URL 和文件系统友好,用 '-' 和 '_' 替代 '+' 和 '/',默认不补等号(可链式调用.withoutPadding()) -
Base64.getMimeEncoder():符合 RFC 2045,每行最多 76 字符并换行,适合邮件协议
常见问题与避坑提醒
实际使用中容易忽略几个关键点:










