Base64 解码失败的两类原因：非法字符与非 UTF-8 字节

Base64 解码分两步：先按字母表把字符还原成字节，再按 UTF-8 把字节还原成文本。第一步失败是「输入不是 Base64」，第二步失败是「字节不是文本」——两者的处理方式完全不同。

第一类：字母表之外的字符

合法字符只有 A-Z a-z 0-9 + / 与填充 =（URL-safe 用 - _）。出现其他字符就失败，工具会指出去掉空白后是第几个。

常见来源：

• 复制时带了换行或空格：多数情况会被忽略，但夹杂在中间的制表符、全角空格不会被忽略。
• 被 URL 编码过：+ 变成 %2B、= 变成 %3D，需要先 URL 解码。
• 粘贴时被截断或拼接：两段 Base64 中间夹了一句说明文字。
• 数据被改过：从文档复制时智能引号把 ' 替成了中文引号，虽然 Base64 不含引号，但周边文本可能混入。

第二类：字节不是合法 UTF-8

字符都合法、也成功还原成了字节，但这些字节拼不出合法 UTF-8 文本。这说明原始数据是二进制：图片、PDF、压缩包、加密后的密文。

Base64 本来就能编码任意字节，所以「解不出文本」不是错误，只是「这段数据不是文字」。工具会明确提示这一点，而不是塞一堆替换字符给你。

要查看二进制内容，应该先把它还原成文件（下载/保存），再用对应的查看器打开，而不是当文本读。

最常见的坑：URL 里的 + 变成了空格

标准 Base64 的 + 在查询字符串里会被解码成空格。所以你可能拿到一段「看起来对、但解不开」的 Base64——里面本该是 + 的位置变成了空格。

处理办法：把空格换回 + 再解。更彻底的办法是让上游改用 URL-safe 变体，从源头避开这个问题。

解码前会自动做的三件事

1. 去掉所有空白（换行、空格、制表符）。
2. 把 - 与 _ 换回 + 与 /。
3. 按长度补回缺失的 =。

这三步覆盖了绝大多数「长度对但解不开」的情况，也让 URL-safe 与省略填充的输入都能直接用。处理完之后仍失败，就只剩上面两类真实错误。