怎么用Java实现一个基础的Base64编码工具_原生类库实战-java教程-PHP中文网

Java 8+ 应使用 java.util.Base64，因其官方、稳定、线程安全；sun.misc.BASE64Encoder 是内部API，JDK 9+ 默认禁用，会导致 IllegalAccessError。

怎么用java实现一个基础的base64编码工具_原生类库实战

Java 8 引入的 java.util.Base64 是官方、稳定、线程安全的实现；sun.misc.BASE64Encoder 属于内部 API，JDK 9+ 默认禁止反射调用，运行时会抛 IllegalAccessError 或编译失败。

编码用 Base64.getEncoder().encodeToString(byte[])，返回 String；解码用 Base64.getDecoder().decode(String)，返回 byte[]
如果处理二进制数据（比如图片字节流），必须先转 byte[]，不能对原始字符串直接 encode——否则默认用平台编码（如 Windows-GBK）转字节，跨平台会乱码
不需要额外依赖，JDK 自带，但注意最低 JDK 版本：JDK 8u121+ 修复过某些边界缓冲区问题，老版本慎用于超长输入

标准 Base64 编码不换行；MIME 规范要求每 76 字符加 \r\n。如果你对接邮件协议或旧系统，得选对编码器。

Base64.getEncoder()：无换行，输出紧凑，适合 URL、JSON、HTTP Header 场景
Base64.getMimeEncoder()：每 76 字符插入 \r\n，结尾带换行，符合 RFC 2045；但解码时 Base64.getDecoder() 能自动忽略所有空白字符，所以解码端无需匹配编码器类型
自定义换行间隔？不行——Base64.Encoder 没有公开构造函数，无法传入行宽参数；真有特殊需求，得自己切片 + 拼接 \n

标准 Base64 的 + 和 / 在 URL 里有特殊含义，= 作填充也容易被截断；getUrlEncoder() 专为 URI/cookie/文件名设计，用 - 替 +、_ 替 /，且默认不填充（可选）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

生成 token 或签名参数时，优先用 Base64.getUrlEncoder().withoutPadding().encodeToString(bytes)
解码必须用 Base64.getUrlDecoder()，不能混用 getDecoder()——虽然多数情况下能碰巧成功，但遇到末尾缺失填充位时会抛 IllegalArgumentException: Illegal base64 character
注意：URL 编码器不处理 UTF-8 字符串本身，仍需先 "你好".getBytes(StandardCharsets.UTF_8)，再 encode

Base64.encodeToString(byte[]) 必须持有完整字节数组，100MB 文件就占 100MB 堆内存，还额外分配约 133MB 编码后字符串（Base64 膨胀率 ~4/3），极易 OOM。

大文件或流式场景，用 Base64.Encoder.wrap(OutputStream) 包装目标流，边读边写：encoder.encode(new FileInputStream("in.bin")).transferTo(new FileOutputStream("out.b64"))
别用 String.getBytes() 无参重载——它依赖系统默认编码，Windows 和 Linux 表现不同；显式传 StandardCharsets.UTF_8
Android 开发注意：API 26+ 才完整支持 java.util.Base64，低版本需回退到 android.util.Base64，两者 API 几乎一致，但类名和包名不同

真正麻烦的是混合场景：比如 HTTP 请求体要 Base64 编码上传，但服务端又要求 MIME 换行格式，这时候得确认对方是否真的校验换行——很多所谓“MIME 兼容”接口其实只认无换行 Base64，连 \r\n 都会解析失败。