Base64URL 转 Base64 转换器：补全填充

如何将 Base64URL 转换为 Base64

1. 把 Base64URL 粘贴到 输入 · Base64URL。填充可有可无，输入中出现标准的 + 和 / 也没问题。
2. 标准 Base64 显示在 输出 · Base64 中，- 和 _ 已换成 + 和 /，填充也已补全。
3. 输出下方的 填充（=） 默认开启；换行 可以把结果按 64 个字符（PEM）或 76 个字符（MIME）断行。
4. 点击 复制输出。切换为 Base64 → Base64URL，或使用 Base64 转 Base64URL，即可反向转换。

需要补多少填充

Base64 以 4 个字符为一组。Base64URL 通常会省略用来填满最后一组的 =，所以根据长度就能知道要补回几个：

常见的示例载荷 eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ 有 70 个字符，余数为 2，所以结果就是在同一字符串末尾加上 ==。完整的推导见 填充指南。

为什么可能需要标准 Base64

很多解码器只接受标准字母表，遇到 Base64URL 时的失败方式各不相同：

• GNU coreutils 的 base64 -d 会输出第一个 - 或 _ 之前已解码的内容，然后报 base64: invalid input。
• Java 的 Base64.getDecoder() 会抛出 IllegalArgumentException；处理 URL 安全输入要用 Base64.getUrlDecoder()。
• .NET 的 Convert.FromBase64String 遇到 -、_ 或缺少 = 时会抛出 FormatException。
• Python 的 base64.b64decode 最危险：默认情况下，它会丢弃标准字母表以外的字符而不报错。b64decode("PDw_Pz8-Pg==") 返回的是 b'<<\x0f\xcf\xc3\xe0'，而不是 b'<<???>>'。

最后这种情况值得在所有处理令牌的代码中专门测试。字节错了却没有异常，问题往往要很久以后才会暴露，表现为签名校验失败或数据损坏。

在代码中将 Base64URL 转为 Base64

import base64

def b64url_to_bytes(s: str) -> bytes:
    return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

b64url_to_bytes("PDw_Pz8-Pg")                              # b'<<???>>'
base64.b64encode(b64url_to_bytes("PDw_Pz8-Pg")).decode()   # 'PDw/Pz8+Pg=='

-len(s) % 4 就是缺少的 = 个数：对有效输入来说是 0、1 或 2。urlsafe_b64decode 需要填充，所以要在调用之前补上。

function b64urlToB64(s) {
  const b = s.replace(/-/g, "+").replace(/_/g, "/");
  return b + "=".repeat((4 - (b.length % 4)) % 4);
}
b64urlToB64("PDw_Pz8-Pg");   // 'PDw/Pz8+Pg=='

在 Node.js 中，Buffer.from(s, "base64url").toString("base64") 一次调用就能完成同样的转换。各语言标准库中的 URL 安全解码器，请参阅 Python、Java 和 C# 页面。

常见问题

• “最后一组字符不完整”。 长度除以 4 余 1。字符串的一部分丢失了，常见于换行处，或者 URL 被截断。
• 输入中有 .。 JWT 用点号连接三个 Base64URL 片段。请一次转换一个片段；JWT 解码器 则可以直接读取整个令牌。
• 字符串中有 %3D。 该值在 Base64URL 之外还做了百分号编码。请先用 URL 解码 处理。

常见问题