JSON 转 Base64：编码 JSON 载荷

如何把 JSON 编码为 Base64

1. 把 JSON 粘贴到 输入 · 文本，或按 示例 载入一个示例对象。
2. 从 输出 · Base64 复制 Base64。大小数字会显示它变长了多少。
3. 用于 URL、Cookie 或类似令牌的值时，勾选 URL 安全（- _） 和 不填充（=）。
4. 下载 会把结果保存为 base64.txt。

本页的示例 {"id":42,"name":"base64hub","tags":["json","encode"],"active":true} 有 67 字节，编码结果是 eyJpZCI6NDIsIm5hbWUiOiJiYXNlNjRodWIiLCJ0YWdzIjpbImpzb24iLCJlbmNvZGUiXSwiYWN0aXZlIjp0cnVlfQ==。要检查结果，按 互换，或使用 Base64 转 JSON，它还能格式化输出。

空白和格式会改变 Base64

Base64 编码的是 JSON 文本中的每一个字符，所以两个含义相同的文档，只要有一个空格不同，Base64 就不同：

当 Base64 要被比较、缓存或签名时，请用同一个序列化器和固定的设置生成 JSON，再对这个确切的字符串编码。键的顺序是另一个陷阱：大多数序列化器保持插入顺序，所以 {"a":1,"b":2} 和 {"b":2,"a":1} 的编码结果不同。

Python 和 JavaScript 默认就不一致

对象 {"name": "Zoë", "n": 1} 用各语言的默认设置序列化：

勾选 URL 安全和不填充后，JavaScript 版本会变成 eyJuYW1lIjoiWm_DqyIsIm4iOjF9。

Base64 JSON 的使用场景

• HTTP 请求头。 携带上下文的自定义请求头（例如链路追踪或用户元数据）经常存放 Base64 JSON，因为原始 JSON 中的引号和非 ASCII 字符放在请求头值中并不安全。很多服务器会拒绝超过约 8 KB 的请求头行，所以这类载荷要尽量小。
• URL 参数。 OAuth 的 state 值、重定向目标和分享链接有时会以 Base64URL 携带一个小 JSON 对象。
• 环境变量和密钥。 整个 JSON 配置无需转义就能放进一个变量，例如 CI 系统中的服务账号密钥。
• 令牌格式。 JWT 的头部和载荷是不带填充、经 Base64URL 编码的 JSON。要生成签名的令牌，请使用 JWT 编码器；本页只负责编码。

Base64 会让体积增加三分之一，而 JSON 自身的引号和键往往比值还长。Base64 的体积开销 说明了什么时候先压缩更划算。

在代码中把 JSON 转为 Base64

const obj = { name: "Zoë", n: 1 };
const bytes = new TextEncoder().encode(JSON.stringify(obj));
btoa(String.fromCharCode(...bytes));                     // "eyJuYW1lIjoiWm/DqyIsIm4iOjF9"
Buffer.from(JSON.stringify(obj)).toString("base64url"); // "eyJuYW1lIjoiWm_DqyIsIm4iOjF9" (Node.js)

如果省略 TextEncoder 这一步，btoa(JSON.stringify(obj)) 会把 ë 编码为单个 Latin-1 字节（eyJuYW1lIjoiWm/rIiwibiI6MX0=），UTF-8 解码器无法读取；遇到 Emoji 等超出 Latin-1 范围的字符时还会直接报错。

import base64, json

obj = {"name": "Zoë", "n": 1}
text = json.dumps(obj, separators=(",", ":"), ensure_ascii=False)
base64.b64encode(text.encode("utf-8")).decode()   # 'eyJuYW1lIjoiWm/DqyIsIm4iOjF9'

更多选项见 JavaScript、Node.js 和 Python 页面。

常见问题