base64工具类仅负责字节数组与字符串的编解码，不处理图片逻辑；图片能否正确还原取决于输入字节数组是否完整且格式合法，java中推荐使用java.util.base64原生api，需确保原始字节含文件头、剥离data:前缀、补全填充并校验长度为4的倍数。
Base64 工具类本身不处理图片逻辑，它只做字节数组和字符串的编解码；图片能否正确还原，完全取决于你传入的字节数组是否完整、格式是否合法。
Java 中用 java.util.Base64 编码图片字节数组
这是最常用也最安全的方式，JDK 8+ 原生支持，无需第三方依赖。
关键点：
-
Base64.getEncoder().encodeToString(byte[])接收的是原始图片字节（比如Files.readAllBytes(Paths.get("a.jpg"))），不是经过压缩或截断的数据 - 如果图片是从
BufferedImage生成的，必须先写入ByteArrayOutputStream再获取字节数组，不能直接调用getRaster().getDataBuffer().getData()—— 那只是像素数据，不含文件头信息，解码后打不开 - 编码结果是纯 ASCII 字符串，可直接嵌入 JSON 或 HTML 的
src="data:image/jpeg;base64,..."中
Java 中用 Base64.getDecoder() 解码回图片字节数组
解码失败通常不是 Base64 问题，而是输入字符串本身不合规。
常见错误现象：
- 抛
IllegalArgumentException: Input is not a valid Base64 string：字符串含空格、换行、HTML 实体（如 - 解码后文件损坏：原始字符串被截断（比如数据库字段长度不够）、或前端上传时误用了
readAsText而非readAsDataURL - 注意
Base64.getDecoder().decode(String)会严格校验填充字符=，缺失会导致异常；若来源不可控，建议先用正则补全：s.replace("-", "+").replace("_", "/").replaceAll("[^A-Za-z0-9+/]", "")，再确保长度是 4 的倍数（末尾补=）
Spring Boot 接口里传 Base64 图片字符串要注意什么
HTTP 请求体中传输 Base64 字符串，看似简单，实则容易在边界上出问题。
实操建议：
- 前端发送时，用
JSON.stringify({ image: "data:image/png;base64,..." })，后端接收字段类型定义为String，但必须剥离data:...;base64,前缀再解码 —— 否则Base64.getDecoder()会因非法字符报错 - 不要把 Base64 字符串存在
TEXT类型数据库字段里还设了 1024 长度限制：一张 1MB 的 PNG 编码后约 1.37MB，远超限制 - 如果接口要支持大图，考虑改用
MultipartFile直传二进制，Base64 只用于小图标或临时预览场景
Python 的 base64.b64encode 和 b64decode 行为差异
和 Java 不同，Python 的 base64 模块默认返回 bytes，不是 str。
容易踩的坑：
- 编码后忘记调用
.decode('utf-8')转字符串，导致 JSON 序列化失败（TypeError: Object of type bytes is not JSON serializable） - 解码时传入
str却没 encode 回bytes：正确写法是base64.b64decode(s.encode('utf-8'))，而不是base64.b64decode(s) - 读取图片文件要用
open(path, 'rb').read()，用'r'模式会因编码问题直接报错
真正麻烦的从来不是 Base64 编解码本身，而是字节数组从哪来、到哪去、中间有没有被转义、截断、误解析。只要源头字节干净，Base64 就不会出错；一旦出错，优先查上游数据完整性，而不是怀疑工具类。
