Base64编码必须作用于字节数组而非字符串拼接结果；正确做法是先拼接原始内容（字符串或字节），再统一转为UTF-8字节数组，最后编码；避免分段编码、忽略编码声明及内存溢出。
直接用 StringBuilder 拼接原始字节再 Base64 编码是错的——Base64 编码必须作用于字节数组，不是字符串拼接后编码。正确做法是先拼好原始内容（字符串或字节），再统一转字节数组，最后用 Base64 编码。
拼接字符串再整体 Base64 编码
适用于拼接的是纯文本（如 JSON 片段、参数键值对等），且最终需 Base64 表示该文本。
- 用
StringBuilder高效拼接字符串（避免 + 连接） - 拼完后调用
.toString()得到完整字符串 - 用
java.util.Base64.getEncoder().encodeToString(str.getBytes(StandardCharsets.UTF_8))编码
示例：
StringBuilder sb = new StringBuilder();sb.append("{\"id\":123}").append(",{\"name\":\"张三\"}");
String raw = sb.toString();
String encoded = Base64.getEncoder().encodeToString(raw.getBytes(StandardCharsets.UTF_8));
拼接字节再统一 Base64 编码（更通用）
适合含二进制数据、非 UTF-8 安全字符，或需精确控制编码输入的场景。
- 不推荐用
StringBuilder拼字节——它专为字符设计 - 改用
ByteArrayOutputStream或预估长度的byte[]缓冲区 - 把各段内容（字符串、文件片段等）分别写入流，再调用
Base64.getEncoder().encodeToString(baos.toByteArray())
若坚持用 StringBuilder 处理文本段，可先拼好每段字符串，再逐段转字节并合并：
StringBuilder sb2 = new StringBuilder().append("world");
byte[] b1 = sb1.toString().getBytes(StandardCharsets.UTF_8);
byte[] b2 = sb2.toString().getBytes(StandardCharsets.UTF_8);
byte[] full = new byte[b1.length + b2.length];
System.arraycopy(b1, 0, full, 0, b1.length);
System.arraycopy(b2, 0, full, b1.length, b2.length);
String result = Base64.getEncoder().encodeToString(full);
避免常见坑
- 别对每段分别 Base64 再拼接：Base64 编码块有填充（=）、换行规则，分段编码会导致结果不可逆
-
别忽略字符编码：用
getBytes(UTF_8)，不用无参getBytes()（依赖平台默认编码） -
大字符串注意内存：如果原始内容超百 MB，考虑流式处理（如
Base64.Encoder.wrap(OutputStream)）而非全量加载
需要流式拼接+编码？用 Encoder.wrap
适用于边生成边编码、内存受限场景（如日志组装、大文件摘要）。
- 创建
ByteArrayOutputStream或文件输出流 - 用
Base64.getEncoder().wrap(outputStream)包装 - 向包装流写入原始字节（可用
StringBuilder.toString().getBytes()转） - 自动完成 Base64 编码并写入目标位置
这样既避免中间字符串驻留内存，又保证编码完整性。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
