当前位置：首页 > 文章列表 > Golang > Go教程 > Go crypto/rand 生成令牌并避免短随机数

Go crypto/rand 生成令牌并避免短随机数

来源：17golang原创 2026-10-04 00:46:25 0浏览收藏

Go 生成登录链接、幂等键或一次性访问令牌时，核心不是把字符串拼得更长，而是使用不可预测的随机源并先定下随机预算。Go 1.24 及以上可以直接用 crypto/rand.Text()；需要兼容更早版本时，用 32 字节随机值编码为 URL-safe Base64。这样做比时间戳、math/rand 或截取短随机串更可靠。

官方地址：https://pkg.go.dev/crypto/rand

落地要点

文本令牌至少按 128 位随机性设计，重要凭证可直接使用 256 位随机值。
编码只改变表现形式，不会替代随机预算；URL 场景优先选 RawURLEncoding。
令牌只存摘要或受控存储，生成失败、重复键和过期轮换分别处理。

一、先确定令牌的随机预算

先问清楚令牌的用途：登录链接和短期邀请通常需要不可预测的文本；幂等键还要能在业务时间窗内稳定去重；长期凭证则应把轮换和撤销一起设计。字符数量不是随机强度，关键是有效随机位数。例如 16 个十六进制字符只有 64 位随机性，不能因为看起来“够长”就直接用于高价值凭证。

rand.Text() 的结果使用 RFC 4648 Base32 字符表，官方文档说明其随机性至少为 128 位，适合“需要一个秘密文本”的场景。若服务接口、数据库字段或安全策略希望固定预算，可以直接选择 32 字节，也就是 256 位随机值，再决定如何编码。

Go 令牌随机预算的静态结构说明图 — 图1：说明图展示文本令牌、随机字节、编码方式与随机预算之间的静态关系，不是运行截图。

二、用 crypto/rand 生成 URL 安全令牌

下面的兼容写法将随机源和编码分开：rand.Read 负责填满字节切片，base64.RawURLEncoding 负责移除 URL 中不友好的字符和填充符。返回错误后立即停止，不要返回一个不完整的令牌。

package token

import (
	"crypto/rand"
	"encoding/base64"
)

// NewURLToken 生成 32 字节随机值，编码后适合放在 URL 查询参数中。
func NewURLToken() (string, error) {
	buf := make([]byte, 32)
	// crypto/rand.Read 会填满 buf；错误时不能继续使用半成品。
	if _, err := rand.Read(buf); err != nil {
		return "", err
	}
	// Raw 编码不带 = 填充，URL 中的 + 和 / 也会被替换为安全字符。
	return base64.RawURLEncoding.EncodeToString(buf), nil
}

如果项目已经统一到 Go 1.24 或更新版本，需要的是一般文本令牌而不是固定编码，可以用更短的封装：

package token

import "crypto/rand"

// NewTextToken 使用标准库维护的安全文本随机源。
func NewTextToken() string {
	// rand.Text 已保证至少 128 位随机性；这里不再截取结果。
	return rand.Text()
}

不要把 math/rand 的输出、当前时间、用户 ID 或自增序号直接拼进凭证。它们可以作为业务关联字段，却不能替代密码学随机源。

三、把错误、存储和轮换边界补齐

生成成功只代表拿到了候选值，不代表令牌生命周期已经安全。写入数据库时仍要对唯一键冲突做有限重试；读取时比较摘要或使用受保护的存储字段；一次性令牌要有明确的过期时间和消费标记。日志只记录请求关联 ID，不打印完整令牌。

// ConsumeToken 只展示边界判断，存储实现由业务层提供。
func ConsumeToken(token string, now time.Time) error {
	if token == "" {
		return errors.New("empty token")
	}
	// 查询时同时判断过期、已消费和用途，避免只验证字符串存在。
	record, err := store.FindToken(hashToken(token))
	if err != nil {
		return err
	}
	if record.ExpiredAt.Before(now) || record.Consumed {
		return ErrTokenUnavailable
	}
	// 成功消费要与状态更新放在同一事务或等价的原子操作中。
	return store.MarkConsumed(record.ID)
}

上例中的 hashToken 只表示“存摘要”的边界，实际哈希算法和密钥策略应按令牌用途选择。高价值会话还需要撤销、轮换、设备绑定或重新认证，不要把“随机”误当成完整的身份管理。