关于此工具
Base64URL 编码(RFC 7515 / RFC 4648 规范)是现代 JWT(JSON Web Token)、OAuth 2.0 PKCE 鉴权、WebAuthn 生物密钥认证及 Web 安全传输中不可或缺的 URL 安全变体。标准 Base64 编码中包含加号 `+` 与正斜杠 `/`,这两者在 URL 查询参数或路径中会引起严重歧义(`+` 容易被 HTTP 服务器误视为空格,`/` 会破坏路径层级),且末尾等号 `=` 在某些网关处会引发解析异常。Base64URL 将 `+` 替换为减号 `-`,将 `/` 替换为下划线 `_`,并省略末尾所有等号,实现 100% 网址安全传输。本工具提供纯前端本地标准 Base64 与 Base64URL 双向极速互转。
如何使用本工具(操作步骤)
输入待处理的字符串或密文
在输入区粘贴原始明文文本、标准 Base64 字符串、或从 JWT Token 中解构出的 Base64URL 密文片段。
选择转换方向与模式
挑选操作模式:「文本转 Base64URL」、「Base64URL 解码为文本」、或「标准 Base64 与 Base64URL 一键互转」。
一键复制 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 字符差异对照表
含字符: A-Z, a-z, 0-9, '+' 和 '/'
末尾填充: 包含 '=' 或 '=='
URL传输: 危险!'+' 易被误视为空格,'/' 破坏路径含字符: A-Z, a-z, 0-9, '-' 和 '_'
末尾填充: 强制省略全部 '=' 填充符
URL传输: 100% 安全!可直接放在网址路径与参数中* JWT 的 Header 和 Payload 正是使用 Base64URL 编码后以点号拼接而成的。
JavaScript 原生实现 Base64 与 Base64URL 互转代码
function base64ToBase64Url(base64) {
return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
}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 乱码与越界报错。