Go encoding/base64 怎样兼容 URL 安全的无填充编码

Go 里要生成“URL 安全、而且不带 = 填充”的 Base64，直接使用 base64.RawURLEncoding。它在 URLEncoding 的基础上把标准字母表里的 +、/ 换成 -、_，同时关闭末尾填充；解码端也必须使用同一个编码器，不能只把字符串末尾的等号随手删掉。

先把 URL 安全和无填充拆成两个独立选择

Base64 的“URL 安全”与“无填充”不是同一个开关。URLEncoding 使用 RFC 4648 的 URL 字母表，适合放在 URL 或文件名中；它默认仍然使用 = 补齐长度。RawURLEncoding 则是同一套 URL 字母表加上 NoPadding。

因此，若接口文档写的是“base64url without padding”，Go 的对应项就是 RawURLEncoding，而不是先调用标准编码再做字符串替换。

RawURLEncoding 的最小编码与解码写法

编码时把输入转换成字节切片，解码时检查错误即可。这里故意不手写 Base64 字符表，避免协议细节散落在业务代码里：

package main

import (
    "encoding/base64"
    "fmt"
)

func main() {
    payload := []byte("user=42&scope=read")

    // RawURLEncoding 同时保证 URL 安全并省略末尾填充。
    token := base64.RawURLEncoding.EncodeToString(payload)
    fmt.Println(token)

    // 解码端必须使用相同的字母表和填充约定。
    decoded, err := base64.RawURLEncoding.DecodeString(token)
    if err != nil {
        // 外部输入不可信时，把格式错误当作输入错误处理。
        fmt.Println("base64url 解码失败:", err)
        return
    }
    fmt.Println(string(decoded))
}

EncodeToString 的结果可以直接作为 URL 组件的候选值，但是否需要再做 URL 查询参数转义，仍取决于你把它放在路径、查询参数还是表单中。Base64 编码器只负责字母表和填充，不替代整个 URL 编码流程。

带填充和无填充输入不能靠猜，先固定协议

最常见的兼容问题是：发送方使用 RawURLEncoding，接收方却用 URLEncoding 解码，输入长度不是四的倍数时就会报错；反过来，发送方保留了 =，接收方却强制使用 raw 解码，也可能得到格式错误。两端应该先约定一种格式，再让编码器表达这个约定。

func decodeURLBase64(input string, padded bool) ([]byte, error) {
    enc := base64.RawURLEncoding
    if padded {
        // 只有协议明确保留等号时才使用带填充编码器。
        enc = base64.URLEncoding
    }

    // DecodeString 会返回解码后的字节和具体格式错误。
    return enc.DecodeString(input)
}

如果历史接口确实同时接受两种输入，也建议把“兼容策略”放在协议适配层，并记录输入来源；不要在核心业务里无条件补等号或删等号。自动修补可能把截断、错误字母表等真正的问题掩盖掉。

跨语言传递时检查这四个边界

• 字母表：确认对端使用的是标准 +/，还是 URL 安全的 -_。
• 填充：明确末尾是否允许 =，不要只根据当前样本长度推断。
• 空输入：空字节经过编码后是空字符串，协议需要决定它代表空值还是缺少字段。
• 错误处理：对外部输入保留 error，不要把解码失败当成空字节继续签名或鉴权。

如果协议只要求 URL 安全且无填充，最小决策就是固定使用 RawURLEncoding；如果必须兼容旧格式，则把带填充版本作为明确的第二种输入格式，而不是修改正文数据。

常见问题

RawURLEncoding 和 URLEncoding 有什么区别？

两者都使用 URL 安全字母表，区别是 RawURLEncoding 关闭了 = 填充，而 URLEncoding 默认保留填充。

能不能先用 StdEncoding 再替换字符？

不建议。这样还要额外处理填充和解码规则，容易让两端的协议约定不一致；应直接选择与协议匹配的编码器。

为什么无填充字符串解码失败？

通常是解码端仍使用带填充的 URLEncoding，或者输入本身被截断。先确认发送端的编码器、填充约定和完整传输内容。