Python base64 编码的真实用途

base64不是加密而是二进制到ASCII的编码，用于文本环境传输；需.decode(‘ascii’)转字符串才能用于data url；url场景须用urlsafe_b64encode()；大文件易oom，应避免全量编码；无完整性校验，需额外加哈希或签名。

base64 不是用来“加密”的，它只是把二进制数据转成 ASCII 字符串，方便在纯文本环境里传输或嵌入——比如 http header、json 字段、HTML data URL，或者配置文件里存一张小图标。

为什么不能用 base64.b64encode() 直接传给前端当图片？

常见错误是拿到 bytes 后直接调 base64.b64encode()，结果得到的是 bytes 类型的编码结果（如 b'AAABAA=='），前端 src="data:image/png;base64,b'AAABAA=='" 会失败。

• 必须用 .decode('ascii') 转成字符串，才能拼进 data URL
• 完整写法：base64.b64encode(data).decode('ascii')
• 别用 utf-8 解码——base64 输出只含 ASCII 字符，用 ascii 更准确，出错时也更容易暴露问题

base64.urlsafe_b64encode() 什么时候必须用？

标准 base64 生成的字符串含 + 和 /，在 URL 或文件名里会被误解析（比如当路径分隔符或查询参数分隔符）。这时候得换安全变种。

• URL 查询参数、JWT 的 payload、redis key 名里嵌 base64 数据 → 用 urlsafe_b64encode()
• 注意：它用 - 替代 +，_ 替代 /，结尾的 = 可能被截断（尤其在 URL 中）
• 解码时统一用 base64.urlsafe_b64decode()，它自动兼容缺 padding 的情况

大文件用 base64 编码会卡死？

会。base64 编码后体积膨胀约 33%，而且 python 默认一次性加载全部内容到内存 —— 读一个 500MB 的视频再编码，大概率 OOM。

立即学习“Python免费学习笔记（深入）”；

• 真实场景中，大文件别全量 base64；改用流式上传、分片、或直接传二进制（如 multipart/form-data）
• 真要编码，先确认是否必要：前端 canvas 导出图、小图标内联、配置项里存 Token 签名 → 合理；传 PDF 报表 → 不合理
• 如果非做不可，至少用 io.BytesIO 控制 chunk 大小，别用 open(...).read()

最容易被忽略的一点：base64 编码不提供任何完整性校验。传过去的数据被中间人改了几个字节，解码可能成功但内容错乱，且不会报错。需要校验就加 hashlib 或用带签名的方案，别指望 base64 自己扛。