如何将 UUID 安全、紧凑地编码为 URL 友好字符串-Golang

本文详解为何直接对 `uuid.string()` 进行 base64 编码会导致长度翻倍（48 字符），并提供正确做法：直接对 16 字节原始 uuid 数据进行 url 安全 base64 编码，得到标准的 22 字符无填充短标识符。

在构建 RESTful API 时，使用短小、唯一且 URL 安全的资源 ID（如 /users/EaHttz1oSvJnCVQOaPWLAQ）能显著提升可读性与缓存友好性。UUID v4 是理想的随机唯一源，但其标准十六进制字符串格式（36 字符，含连字符）过长；而错误的 Base64 编码方式反而会使其更长（48 字符），这正是问题根源。

根本原因：你编码的是 UUID 的 字符串表示（uid.String() 返回类似 “8ba77a82-679b-49b2-608a-86db0639402c” 的 36 字符 UTF-8 字符串），而非 UUID 的 原始字节。该字符串共 36 字节，经 Base64 编码后长度为 ceil(36 × 4/3) = 48 字符（含填充 =），完全背离压缩初衷。

正确做法：UUID 本质是 16 字节（128 位）的二进制数据。应直接对其字节切片进行 URL 安全 Base64 编码：

package main

import (
    "encoding/base64"
    "fmt"

    "github.com/nu7hatch/gouuid"
)

func printShortUUID() {
    uid, _ := uuid.NewV4()
    // ✅ 正确：编码原始 16 字节数据（uid[:] 是 [16]byte 的切片）
    uid64 := base64.URLEncoding.EncodeToString(uid[:])
    fmt.Println(uid64, len(uid64))
}

func main() {
    for i := 0; i < 5; i++ {
        printShortUUID()
    }
}

运行结果示例：