Java Base64 編解碼實戰：JDK 內置 Base64、Apache Commons、陽春版手寫實現全對比

Base64 是二進制數據轉文本的標準編碼，廣泛用於 HTTP 傳輸、JSON 嵌入圖片、Token 編碼等場景。本文對比 JDK 8+ 內置 API、Apache Commons Codec、舊版 sun.misc 內部類與手寫實現，給出生產級選型建議。

方案對比總覽

JDK 8+ 標準 API 最佳實踐

基本編解碼

import java.util.Base64;

String original = "Hello, Base64!";

// 標準編碼
String encoded = Base64.getEncoder().encodeToString(original.getBytes(StandardCharsets.UTF_8));
// 解碼
String decoded = new String(Base64.getDecoder().decode(encoded), StandardCharsets.UTF_8);

System.out.println("編碼: " + encoded); // SGVsbG8sIEJhc2U2NCE=
System.out.println("解碼: " + decoded); // Hello, Base64!

URL/文件名安全變體（無 + / =）

// URL 安全編碼：+ → -, / → _, 去除填充 =
String urlSafe = Base64.getUrlEncoder().encodeToString(data);
// 對應解碼器自動處理
String decoded = new String(Base64.getUrlDecoder().decode(urlSafe), StandardCharsets.UTF_8);

MIME 變體（每 76 字符換行）

String mime = Base64.getMimeEncoder().encodeToString(largeData);

流式處理大數據（避免 OOM）

try (InputStream in = new FileInputStream("big.bin");
     OutputStream out = new FileOutputStream("big.b64");
     OutputStream encoder = Base64.getEncoder().wrap(out)) {
    in.transferTo(encoder); // JDK 9+ 零拷貝
}

Apache Commons Codec 用法

    commons-codec
    commons-codec
    1.16.0

import org.apache.commons.codec.binary.Base64;

byte[] encoded = Base64.encodeBase64(data);
byte[] decoded = Base64.decodeBase64(encoded);
// URL 安全
String urlSafe = Base64.encodeBase64URLSafeString(data);

舊版 sun.misc 遷移指南

原代碼（高風險）：

import sun.misc.BASE64Encoder;
import sun.misc.BASE64Decoder;

String encoded = new BASE64Encoder().encode(bytes);
byte[] decoded = new BASE64Decoder().decodeBuffer(encoded);

遷移步驟：

1. 替換 import 為 java.util.Base64
2. 編碼：Base64.getEncoder().encodeToString(bytes)
3. 解碼：Base64.getDecoder().decode(string)
4. 指定字符集：StandardCharsets.UTF_8

效能基準參考 (JMH, 1MB 數據)

JDK 內置實現使用查表法 + 位運算優化，並針對現代 CPU 指令集（AVX2/SSE）向量化，效能最優。

常見坑點

1. 字符集未顯式指定：跨平台亂碼源頭，務必 StandardCharsets.UTF_8
2. 大文件全量讀入內存：必須用流式 wrap() 處理
3. 雙重編碼/解碼：日誌、傳輸層可能重複處理，需約定單邊處理
4. URL 安全 vs 標準混用：解碼器必須與編碼器配對