Base64 只解决“把任意字节塞进只能放文本的地方”,它不加密、不压缩,也不保证长度更短。下面五个坑几乎每个都真实出现过。

结论先行

  1. Base64 可逆,不是加密;敏感数据不能只做 Base64。
  2. 标准 Base64 的 +、/ 在 URL 和表单里会出事,要改用 URL-safe 变体。
  3. 换行和空白不是数据;解码前统一去掉,或确认解码器会忽略。
  4. 中文先定字符集再编码:UTF-8 和 GBK 的 Base64 结果完全不同。
  5. JWT 用的是 Base64URL 无补位,不要拿标准 Base64 工具硬解。

坑一:把 Base64 当加密

示例用 Python,Java 对应 java.util.Base64。

import base64
token = base64.b64encode(b'password=123456')
print(base64.b64decode(token))   # b'password=123456'

任何能看到密文的人都能还原。Base64 只能隐藏“肉眼可读性”,不能提供机密性。

坑二:+ 和 / 进了 URL

标准字母表包含 + 和 /。把 Base64 直接拼进查询参数时,表单解析会把 + 当成空格(Python 复现):

import base64, urllib.parse
s = base64.b64encode(b'\xfb\xff').decode()   # '+/8='
print(urllib.parse.unquote_plus(s))          # ' /8='  —— 加号没了

两种正确做法(Python):

# 1) URL-safe Base64(JWT 用的就是这种)
print(base64.urlsafe_b64encode(b'\xfb\xff').decode())   # '-_8='
# 2) 标准 Base64 再做一次 percent-encode
print(urllib.parse.quote(s, safe=''))                   # '%2B%2F8%3D'

反过来,拿到 URL-safe 字符串要还原时,先把 -、_ 换回 +、/。

坑三:换行、空格、补位

MIME 邮件里的 Base64 每 76 字符换行,复制到代码里就带上了 \r\n。不同解码器行为不一致:有的忽略空白,有的直接报错(Python 验证):

import base64
raw = 'aGVs\nbG8='          # 中间有换行
clean = ''.join(raw.split())  # 去掉所有空白
print(base64.b64decode(clean))  # b'hello'

补位 = 也不能随便删。标准解码器要求长度是 4 的倍数;JWT 为了短,去掉了 =,解码时需要手动补齐。

坑四:中文编码不一致

Base64 编码的是字节,不是字符。同一句“中文”,UTF-8 和 GBK 的结果不同(Python):

import base64
print(base64.b64encode('中文'.encode('utf-8')).decode())  # 5Lit5paH
print(base64.b64encode('中文'.encode('gbk')).decode())    # 1tDOxA==

所以排查“解出来是乱码”时,先问:编码端用的是 UTF-8 还是 GBK?只换解码器不换字符集,结果仍然是错的。

坑五:JWT 不是标准 Base64

JWT 的三段(header、payload、signature)使用 Base64URL:

  • + → -,/ → _
  • 去掉末尾 =
  • 只对前两段做解码可以看内容,但不代表 token 可信;签名必须用密钥验证。

Python 解出 payload:

import base64, json
seg = 'eyJzdWIiOiIxMDAxIn0'
pad = seg + '=' * (-len(seg) % 4)
print(json.loads(base64.urlsafe_b64decode(pad)))  # {'sub': '1001'}

还有两个小坑

  • Data URI 的 MIME 必须和真实字节一致:data:image/png;base64, 后面接的却是 JPEG 字节,部分浏览器仍能显示,但保存出来的扩展名会错。
  • 体积会变大:Base64 后约为原始的 4/3,给大文件做内嵌会显著拖慢页面。

排查顺序建议:先去空白 → 确认字符集 → 确认字母表是标准还是 URL-safe → 再确认补位。站内可用 Base64 编解码 对照结果,命令见 jq 速查 的 @base64。