Java 8+ 使用Base64.getDecoder().decode()可线程安全地将合法Base64字符串解码为字节数组，需校验格式、清除空白、捕获DecodingException，并注意大文件内存风险。
直接用 Base64.getDecoder().decode() 就能把 Base64 字符串转成原始字节数组，这是 Java 8+ 提供的标准、线程安全方式，无需额外依赖。
确认输入字符串格式合法
Base64 字符串应只含 A–Z、a–z、0–9、+、/ 和结尾可能的 =（填充符），长度是 4 的倍数。若来自 URL 或文件名，可能用了变种编码（如 Base64URL），需改用 Base64.getUrlDecoder()。
- 常见错误：字符串含空格、换行或中文字符 → 解码前先
trim() - 含 Windows 换行符（
replaceAll("\s", "")清除所有空白 - 不确定是否为标准 Base64？可加简单校验：
str.length() % 4 == 0 && str.matches("[A-Za-z0-9+/]*={0,2}")
调用 decode() 获取原始字节数组
该方法返回 byte[]，即还原后的原始二进制数据（可能是图片、JSON、加密密文等），不自动处理字符编码 —— 后续如何解释这些字节，取决于原始内容类型。
- 基础用法：
byte[] bytes = Base64.getDecoder().decode("SGVsbG8=");→ 得到{72, 101, 108, 108, 111}（"Hello" 的 UTF-8 字节） - 若原始数据是文本且已知编码（如 UTF-8），可转字符串：
new String(bytes, StandardCharsets.UTF_8) - 若原始数据是图片，可直接写入文件或构造
InputStream：new ByteArrayInputStream(bytes)
捕获并处理 DecodingException
非法 Base64 字符、长度错误或填充不当会抛出 IllegalArgumentException（Java 8–10）或更明确的 Base64.DecodingException（Java 11+）。建议显式捕获，避免崩溃。
- Java 11+ 推荐写法：
try {
byte[] data = Base64.getDecoder().decode(encodedStr);
// 处理 data
} catch (Base64.DecodingException e) {
System.err.println("Base64 解码失败：" + e.getMessage());
// 可记录日志、返回错误响应等
}
- Java 8–10 则捕获
IllegalArgumentException，但注意它也可能是其他原因抛出，建议结合上下文判断
注意内存与大文件场景
decode() 会一次性将整个 Base64 字符串解码为内存中的字节数组。若字符串超长（如几十 MB 的 Base64 图片），可能导致 OutOfMemoryError。
- 方案一：改用流式解码（需自行包装或借助 Apache Commons Codec 的
Base64InputStream） - 方案二：服务端接收时，优先要求客户端传原始二进制（如 multipart/form-data），而非 Base64 字符串
- 方案三：若必须处理大 Base64，先校验长度上限（如
if (str.length() > 10_000_000) throw new IllegalArgumentException("Base64 过长")）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
