T工具箱
64U

Base64URL 编解码

URL 安全变体,与标准 Base64 互转

关于此工具

Base64URL 编码(RFC 7515 / RFC 4648 规范)是现代 JWT(JSON Web Token)、OAuth 2.0 PKCE 鉴权、WebAuthn 生物密钥认证及 Web 安全传输中不可或缺的 URL 安全变体。标准 Base64 编码中包含加号 `+` 与正斜杠 `/`,这两者在 URL 查询参数或路径中会引起严重歧义(`+` 容易被 HTTP 服务器误视为空格,`/` 会破坏路径层级),且末尾等号 `=` 在某些网关处会引发解析异常。Base64URL 将 `+` 替换为减号 `-`,将 `/` 替换为下划线 `_`,并省略末尾所有等号,实现 100% 网址安全传输。本工具提供纯前端本地标准 Base64 与 Base64URL 双向极速互转。

如何使用本工具(操作步骤)

1

输入待处理的字符串或密文

在输入区粘贴原始明文文本、标准 Base64 字符串、或从 JWT Token 中解构出的 Base64URL 密文片段。

2

选择转换方向与模式

挑选操作模式:「文本转 Base64URL」、「Base64URL 解码为文本」、或「标准 Base64 与 Base64URL 一键互转」。

3

一键复制 URL 安全的结果

转换结果即刻在下方渲染呈现,无 `+` 无 `/` 且无末尾等号,点击复制按钮直接安全地拼入 HTTP 接口或重定向 URL 中。

严格遵循 RFC 7515 URL 安全字符映射

精确将 `+` 映射为 `-`,将 `/` 映射为 `_`,并自动去除末尾充填的 `=` 符号,确保生成的密文可直接作为 GET 参数安全传输。

支持标准 Base64 与 Base64URL 一键互转

无需中转解码,支持直接在传统的标准 Base64 与现代 Base64URL 之间秒级相互转换,特别方便排查鉴权接口协议不一致 Bug。

纯本地离线计算,OAuth 密钥绝对私密

所有字符替换与解码完全在本地浏览器内存中进行,生产环境临时 Token、PKCE 验证码(Code Verifier)绝不上传外网。

Base64URL 协议集成与解码避坑指南

  • •解码时“补齐等号(Padding)”的不可或缺性:标准 Base64 算法要求字符串长度必须是 4 的整倍数。当把省略了等号的 Base64URL 传给原生 `atob()` 时会直接报错!正确的做法是先根据 `length % 4` 的余数自动补全等号再解码。
  • •OAuth 2.0 PKCE 挑战码(Code Challenge)的标准规范:在现代移动端与单页应用 OAuth 流程中,客户端必须对随机密码进行 SHA-256 哈希后,**强制使用 Base64URL 编码**输出给授权服务器,切勿误用标准 Base64!
  • •区分 Base64URL 与 URL Percent-Encoding:Base64URL 是替换两个字符(`-` 与 `_`);而 URL 百分号编码是将字符变为 `%2B` 与 `%2F`。两者解决同一个问题但属于两个不同的协议层,切勿混淆造成双重转码。

代码与转换对比示例

标准 Base64 与 Base64URL 字符差异对照表

标准 Base64 (RFC 4648 传统)
含字符: A-Z, a-z, 0-9, '+' 和 '/'
末尾填充: 包含 '=' 或 '=='
URL传输: 危险!'+' 易被误视为空格,'/' 破坏路径
Base64URL (RFC 7515 安全变体)
含字符: A-Z, a-z, 0-9, '-' 和 '_'
末尾填充: 强制省略全部 '=' 填充符
URL传输: 100% 安全!可直接放在网址路径与参数中

* JWT 的 Header 和 Payload 正是使用 Base64URL 编码后以点号拼接而成的。

JavaScript 原生实现 Base64 与 Base64URL 互转代码

Base64 转 Base64URL
function base64ToBase64Url(base64) {
  return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
}
Base64URL 还原为标准 Base64
function base64UrlToBase64(base64url) {
  let b64 = base64url.replace(/-/g, '+').replace(/_/g, '/');
  // 自动补齐等号填充
  while (b64.length % 4) b64 += '=';
  return b64;
}

* 解码 Base64URL 前,必须先将长度补全到 4 的倍数(补等号),否则 `atob` 会抛错。

常见问题解答

Q: 为什么 Base64URL 要强制去掉末尾的等号(`=`)?

A: 因为等号 `=` 在 URL 中是极其敏感的特殊保留字符(用于分割键名与键值,如 `?key=value`)。如果将包含等号的参数未经再次转义就放入 URL 中,很容易导致很多旧版 Web 服务器的参数解析器产生截断或错位。

Q: Base64URL 是一种加密技术吗?

A: 完全不是加密!它纯粹是一种数据编码格式转换,没有任何密钥保护机制。任何人拿到 Base64URL 字符串,都能在毫秒内还原出原始文本,因此绝不能用于传输未经加密的敏感密码。

Q: 支持直接把中文转换成 Base64URL 吗?

A: 完全支持。本工具内置了完整的 UTF-8 多字节编码转换管道,汉字、Emoji 或日文在转换前会先映射为 UTF-8 字节流,彻底杜绝浏览器 `btoa` 常见的 Unicode 乱码与越界报错。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/