目录

base64url

base64url 就是 Base64 的“URL 安全”版本(RFC 4648 §5)。字母表沿用标准 Base64,只把两个会惹麻烦的符号换掉,并约定可以省略尾部的等号填充,于是它能直接出现在 URL、文件名、Cookie、JWT 这类场景里而无需再转义。

特征 标准 Base64 base64url
第 62 个字符 + -
第 63 个字符 / _
尾部填充 = 省略
规范 RFC 4648 §4 RFC 4648 §5
能否直接放进 URL 需要额外转义 可以

为什么需要它

标准 Base64 的字母表里有三个字符在 URL / 表单上下文里是保留字符:

RFC 4648 因此定义了 base64url:换成 - 和 _,并约定尾部 = 可以省略(因为长度对 4 取模就能推断出该补几个填充)。

字母表

前 62 个字符完全相同,只有后两个换掉了。也就是说,只有当原始数据恰好编码出 + 或 / 时,两者才有差别,所以单纯做字母表替换是安全且可逆的。

编码原理

以两个字节 0xFB 0xFF 为例:

原始:  1111 1011 1111 1111              (16 bit)
补 0:  1111 1011 1111 1111 0000 0000   (凑成 24 bit)
切分:  111110 111111 110000 000000
数值:  62     63     60     0
字符:  + / 8  =      ← 标准 Base64
        - _ 8         ← base64url(省略尾部填充)

长度怎么算

去掉填充后,长度不再一定是 4 的倍数:

原始字节 n 标准 Base64(含 =) base64url(去填充)
1 4 2
2 4 3
3 4 4
4 8 6
5 8 7
n 4×⌈n/3⌉ ⌈4n/3⌉

各语言怎么写

Python

Python 的 urlsafe_b64encode 只换字母表、不去填充,需要自己 rstrip:

import base64
 
raw = b"\xfb\xff"
base64.b64encode(raw).decode()            # '+/8='   标准
base64.urlsafe_b64encode(raw).decode()    # '-_8='   base64url(仍带填充)
 
def b64url_encode(b: bytes) -> str:
    return base64.urlsafe_b64encode(b).decode().rstrip("=")
 
def b64url_decode(s: str) -> bytes:
    s += "=" * (-len(s) % 4)              # 补齐到 4 的倍数
    return base64.urlsafe_b64decode(s.encode())
JavaScript / Node
// Node 14.18+ / 现代浏览器
Buffer.from([0xfb, 0xff]).toString('base64');     // '+/8='
Buffer.from([0xfb, 0xff]).toString('base64url');  // '-_8'
 
// 浏览器里没有 base64url 时手动替换
const b64url = (bytes) => btoa(String.fromCharCode(...bytes))
  .replace(/\+/g, '-')
  .replace(/\//g, '_')
  .replace(/=+$/, '');
Java
String s = Base64.getUrlEncoder()
                  .withoutPadding()
                  .encodeToString(new byte[]{(byte) 0xfb, (byte) 0xff}); // -_8
byte[] b = Base64.getUrlDecoder().decode(s);
Go
enc := base64.RawURLEncoding                    // Raw = 无填充的 URL 安全变体
s := enc.EncodeToString([]byte{0xfb, 0xff})     // "-_8"
b, err := enc.DecodeString(s)
C# / .NET
using Microsoft.AspNetCore.WebUtilities;
 
var s = WebEncoders.Base64UrlEncode(new byte[] { 0xfb, 0xff }); // -_8
var b = WebEncoders.Base64UrlDecode(s);

典型使用场景

常见坑

与其他编码对比

编码 体积变化 可直接放进 URL 说明
Hex +100% 是 最简单、体积最差
标准 Base64 +33% 否(+ / =) 通用二进制转文本
base64url +33% 是 URL / JWT 场景首选
Base32 +60% 是 可人工朗读、常做不区分大小写场景

一图总览

# base64url

## 是什么
- Base64 的 URL 安全变体(RFC 4648 §5)
- 字母表:A-Z a-z 0-9 - _
- 尾部 = 填充可省略

## 为什么要有它
- + 在表单里被解码成空格
- / 是 URL 路径分隔符
- = 是 key=value 分隔符

## 编码原理
- 3 字节 → 4 个 6bit → 查表
- 不足 3 字节低位补 0
- 长度 = ⌈4n/3⌉(去填充)

## 用在哪
- JWT / JWK
- OAuth PKCE
- URL 里的二进制、token
- 文件名 / Cookie

## 注意事项
- 填充必须前后一致
- 标准与 url 解码器别混用
- 不是加密,体积涨 33%
- 大小写敏感