Go crypto/rand.Text 怎么生成随机字符串：字符集、长度与错误处理边界

做登录链接、一次性凭据或临时密钥时，自己拼字符集很容易漏掉随机源、长度和错误处理。Go 1.24 的 crypto/rand.Text 把这件事收成一个无参数函数：返回使用 RFC 4648 Base32 字符集的随机文本，并保证至少 128 位随机性。

调用方真正需要的是安全随机文本

把随机文本放进 URL、Cookie 或后台任务凭据时，调用方通常只关心三件事：字符是否适合传输、随机性是否够用、调用是否足够简单。crypto/rand.Text 正好覆盖这个最小需求，但它不是密码哈希，也不是完整的令牌生命周期方案，过期、撤销和绑定用户仍要由业务处理。

package main

import (
    "crypto/rand"
    "fmt"
)

func main() {
    token := rand.Text()
    fmt.Println(token)
}

这个示例不需要手动创建 rand.Reader，也不需要为默认安全随机源写错误分支。输出可以作为随机文本继续放入业务对象，但不要把输出直接打印到生产日志。

rand.Text 的字符和长度是怎么来的

Go 源码中的 Text 使用 32 个字符组成的 base32alphabet，字符为大写字母和数字 2 到 7。实现先创建 26 字节缓冲区，再调用 Read 填充，最后把每个字节映射到字符表并转换成 string。

26 个 Base32 字符承载的比特数是 130，源码注释用 ⌈log₃₂ 2¹²⁸⌉ = 26 说明了长度设计。文档把承诺写成“至少 128 位随机性”，而不是承诺永久固定 26 个字符；未来版本可能返回更长文本。

不要从字符串长度反推业务格式

如果数据库字段、接口校验或外部协议必须是固定长度，先把这个协议写清楚，再决定是否使用 rand.Text。当前长度可以满足不少内部令牌，但官方已经保留未来加长的可能，硬编码“必须 26 个字符”会把实现细节变成兼容风险。

为什么调用没有 error，Reader 出错怎么办

crypto/rand.Reader 是并发安全的全局安全随机源。crypto/rand.Read 会把目标切片填满；如果底层随机源返回错误，标准库会让程序不可恢复地终止，而不是把错误继续交给 rand.Text。因此 Text 的签名可以保持为 func Text() string。

这不等于“任何随机函数都不用处理错误”。如果你改用自定义的 io.Reader，或者需要把随机字节编码成特殊格式，应直接调用可返回错误的接口并设计失败路径。rand.Text 适合默认安全随机源已经由标准库管理的场景。

和 math/rand 的选择边界

math/rand 适合模拟、抽样和测试数据；它的输出可能具有可预测性，不应拿来生成登录令牌、密码重置链接或签名密钥。需要安全随机文本时，入口应明确写成 crypto/rand，不要只看包名都叫 rand 就混用。这里的安全令牌随机性预算按官方文档所说的 128 bits 理解。

反过来，测试用例若需要可重复结果，也不应该调用 rand.Text 再去断言具体字符串。测试可以验证字符集、非空和业务约束；要验证固定输入下的算法逻辑，应注入可控数据源或使用确定性测试数据。

把 rand.Text 放进业务代码时的三个检查点

检查存储和日志

令牌要设置过期时间、使用次数和撤销策略，数据库里尽量保存不可逆摘要。开发环境也不要把完整令牌写进普通日志，否则日志权限会变成新的泄露面。

检查版本和构建环境

rand.Text 的文档标注为 Go 1.24.0 新增。如果项目的 go.mod 和构建镜像仍低于这个版本，就不能直接使用；迁移时先在 CI 中执行 go version 和 go test ./...，再合并调用改动。

检查协议约束

Base32 文本适合许多文本传输场景，但并不自动满足每个外部协议的大小写、长度或字符要求。接入第三方接口前，先核对它的字段规则；需要自定义字符集时，不要偷偷截短 rand.Text，因为截短会改变随机性预算。

常见问题

rand.Text 每次一定返回 26 个字符吗？

当前实现返回 26 个字符，但文档明确保留未来加长的可能。业务应依赖“至少 128 位随机性”和允许的字段容量，不要把 26 当成永久 API 承诺。

rand.Text 能替代密码哈希吗？

不能。它生成随机文本，适合令牌或临时密钥；用户密码仍需要专用的慢哈希方案、盐和登录失败控制。

测试里可以直接断言 rand.Text 的值吗？

不应该。随机值不可预测，测试应检查字符范围、长度容纳和非空等性质，而不是比较某一次运行的具体文本。

总结

crypto/rand.Text 解决的是“用标准库安全地得到一段可传输随机文本”这个窄问题。记住它的真实链路：Read 填充随机字节，base32alphabet 完成字符映射，最后返回 string。调用前再确认 Go 版本、字段容量和令牌生命周期，基本就不会把方便的 API 用成隐患。