java：7种Base64编码及解码功能解析与性能对比

Java 8新特性探究（十一）Base64详解

BASE64 编码在软件工程中应用极为广泛，但必须明确一点：它并非用于安全领域的加密算法。虽然 Base64 常被误解为一种保护手段，但其安全性极低，极易被逆向还原，因此不能替代真正的加密机制。其核心价值在于确保数据传输的完整性与兼容性，特别是在那些仅允许传输 ASCII 字符的网络协议或网关环境中。通过 Base64，二进制数据可以被转换为纯 ASCII 字符串，从而在 HTTP、MIME 等文本协议中高效传输，避免了二进制数据在文本通道中可能出现的截断或乱码问题。

JDK里面实现Base64的API

回顾 Java 的发展历史，在 JDK 1.6 之前，核心库中并未提供标准的 Base64 工具类。当时开发者若需实现该功能，往往不得不依赖 Sun 或 Oracle JDK 内部的 sun.misc.BASE64Encoder 和 sun.misc.BASE64Decoder。尽管这种方式无需引入第三方依赖，但其稳定性存在隐患，因为在后续的 JDK 版本中这些内部类可能被移除或标记为废弃（使用maven编译时通常会触发警告），且其性能表现也较为平庸，这在后文的性能测试中会有详细体现。

到了 JDK 1.6 时期，javax.xml.bind 包中引入了 DatatypeConverter 类，其中包含 parseBase64Binary 和 printBase64Binary 两个静态方法。这一实现虽然解决了部分需求，但由于其隐藏在 XML 绑定的包结构下，知名度较低，许多开发者并不知晓其存在，导致其在实际项目中的使用率并不高。

Java 8 的发布彻底改变了这一局面。在 java.util 包下，官方正式推出了 Base64 工具类。其设计不仅功能完备，且性能，API 设计简洁直观，极大地降低了开发者的使用门槛。以下将详细介绍该类的具体用法。

java.util.Base64

该类通过一组静态工厂方法，提供了三种不同场景下的 BASE64 编解码器实例，以满足多样化的业务需求：

1）Basic 编码器：遵循标准的 BASE64 规范，适用于大多数通用的数据编码场景，是默认的首选方案。

1 2 3 4 5 6	// 编码 String asB64 = Base64.getEncoder().encodeToString( "some string" .getBytes( "utf-8" )); System.out.println(asB64); // 输出为: c29tZSBzdHJpbmc= // 解码 byte [] asBytes = Base64.getDecoder().decode( "c29tZSBzdHJpbmc=" ); System.out.println( new String(asBytes, "utf-8" )); // 输出为: some string

2）URL 安全编码器：针对 URL 传输场景进行了优化，将标准 Base64 中的斜杠 / 替换为下划线 _，避免了 URL 解析中的歧义，确保编码后的字符串可以直接嵌入 URL 参数中。

1 2 3 4	String urlEncoded = Base64.getUrlEncoder().encodeToString( "subjects?abcd" .getBytes( "utf-8" )); System.out.println( "Using URL Alphabet: " + urlEncoded); // 输出为: Using URL Alphabet: c3ViamVjdHM_YWJjZA==

3）MIME 编码器：专为 MIME 邮件格式设计，生成的输出仅包含字母和数字，并且严格限制每行长度不超过 76 个字符，每行以 \r\n 作为结束符，完全符合 MIME 协议的格式要求。

1 2 3 4 5 6 7	StringBuilder sb = new StringBuilder(); for ( int t = 0 ; t < 10 ; ++t) { sb.append(UUID.randomUUID().toString()); } byte [] toEncode = sb.toString().getBytes( "utf-8" ); String mimeEncoded = Base64.getMimeEncoder().encodeToString(toEncode); System.out.println(mimeEncoded);

第三方实现Base64的API

除了 JDK 自带的实现外，开源社区中也存在多种流行的第三方 Base64 库。首先是 Apache Commons Codec 库中的 org.apache.commons.codec.binary.Base64，它是 Java 生态中最老牌且广泛使用的工具之一。其次是 Google Guava 库提供的 com.google.common.io.BaseEncoding.base64() 静态方法，以其简洁的链式调用风格著称。再者是 net.iharder.Base64，这是一个单类实现的轻量级 jar 包，结构简单。最后值得一提的是 MigBase64，它在十年前曾以“Base64 编码速度最快”而闻名，但其性能是否依然领先，需要通过实际测试来验证。

Base64编码性能测试

前文共介绍了 7 种 Base64 实现方案，其中 JDK 内置 3 种，第三方库 4 种。面对多种选择，进行严格的性能对比显得尤为必要，而基准测试性能测试是最直接且客观的评价手段。

为了全面评估性能，我们首先定义了两种测试接口。

1 2 3 4 5 6 7 8 9 10	private static interface Base64Codec { public String encode( final byte [] data); public byte [] decode( final String base64) throws IOException; } private static interface Base64ByteCodec { public byte [] encodeBytes( final byte [] data); public byte [] decodeBytes( final byte [] base64) throws IOException; }

这两种接口的核心区别在于数据类型的处理：其中一种接口的入参和出参均为 byte 数组，而另一种则涉及 String 类型。由于 byte 到 byte 的转换避免了字符串编解码的额外开销，性能通常优于涉及 String 的操作String，因此我们将测试分为两组进行对比。

1 2 3 4	private static final Base64Codec[] m_codecs = { new GuavaImpl(), new JavaXmlImpl(), new Java8Impl(), new SunImpl(), new ApacheImpl(), new MiGBase64Impl(), new IHarderImpl() }; private static final Base64ByteCodec[] m_byteCodecs = { new ApacheImpl(), new Java8Impl(), new MiGBase64Impl(), new IHarderImpl() };

从接口定义可以看出，仅有 4 种 API 原生支持 byte 到 byte 的高性能转换路径。以下是参与测试的 7 个 Base64 实现类：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

private static class Java8Impl implements Base64Codec, Base64ByteCodec { private final Base64.Decoder m_decoder = Base64.getDecoder(); private final Base64.Encoder m_encoder = Base64.getEncoder(); @Override public String encode( byte [] data) { return m_encoder.encodeToString(data); } @Override public byte [] decode(String base64) throws IOException { return m_decoder.decode(base64); } public byte [] encodeBytes( byte [] data) { return m_encoder.encode( data ); } public byte [] decodeBytes( byte [] base64) throws IOException { return m_decoder.decode( base64 ); } } private static class JavaXmlImpl implements Base64Codec //no byte[] implementation { public String encode( byte [] data) { return DatatypeConverter.printBase64Binary( data ); } public byte [] decode(String base64) throws IOException { return DatatypeConverter.parseBase64Binary( base64 ); } } ..............

后续代码主要展示各 API 的具体调用方式，鉴于篇幅限制，此处不再逐一列出。测试的核心逻辑是生成 100MB 的随机数据，将其分割为 100 字节或 1000 字节的小块，分别执行编码和解码操作，并精确记录耗时。具体实现方法如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

private static TestResult testByteCodec( final Base64ByteCodec codec, final List< byte []> buffers ) throws IOException { final List< byte []> encoded = new ArrayList< byte []>( buffers.size() ); final long start = System.currentTimeMillis(); for ( final byte [] buf : buffers ) encoded.add( codec.encodeBytes(buf) ); final long encodeTime = System.currentTimeMillis() - start; final List< byte []> result = new ArrayList< byte []>( buffers.size() ); final long start2 = System.currentTimeMillis(); for ( final byte [] ar : encoded ) result.add( codec.decodeBytes(ar) ); final long decodeTime = System.currentTimeMillis() - start2; for ( int i = 0 ; i < buffers.size(); ++i ) { if ( !Arrays.equals( buffers.get( i ), result.get( i ) ) ) System.out.println( "Diff at pos = " + i ); } return new TestResult( encodeTime / 1000.0 , decodeTime / 1000.0 ); }

测试结果如下，JVM 启动参数设置为 -Xms512m -Xmx4G：

数据清晰地展示了各实现的性能差异。Sun 内部类的表现令人失望，性能处于末位。IHarder 和 MigBase64 的性能尚可接受，但 MigBase64 昔日“速度之王”的称号已不复存在。在本次测试中，Java 8 引入的 java.util.Base64 展现出最优的运行速度，而 javax.xml.bind.DatatypeConverter 紧随其后，表现次之。

总结

综上所述，如果项目对 Base64 编解码器的性能和可靠性有较高要求，建议优先选择 JDK 内置的工具类。Java 8 中的 java.util.Base64 是目前最佳的选择，它兼具高性能与易用性。若受限于旧版本 Java 环境，JDK 6 中深藏不露的 javax.xml.bind.DatatypeConverter 也是一个非常可靠且性能不错的替代方案，无需再盲目寻找第三方库。