Go crypto/rand.Text 怎么替代自写邀请码：版本门槛、字符集与回归验收

项目里如果还用 math/rand 拼邀请码，或者从一个字节数组里直接截取字符串，迁移到 crypto/rand.Text 能把随机性和字符集处理收回标准库。它返回 RFC 4648 Base32 字符串，当前结果长度为 26 个字符，并提供至少 128 位随机性；但这不是“改一行代码就完事”，Go 版本门槛、长度假设和数据库字段都要一起验收。

先确认升级范围：API 有了，旧代码不一定能编译

crypto/rand.Text 属于 crypto/rand 包，官方实现使用标准 RFC 4648 Base32 字母表，返回值至少包含 128 位随机性。实际迁移时最容易漏掉的是构建环境：开发机可能已经是新 Go，生产 CI 仍然由旧工具链构建。

如果项目必须支持不含该 API 的旧 Go，不要在同一个文件里无条件调用新函数。可以用构建标签拆出新旧实现，让升级是可回退的变更，而不是把编译错误推到发布阶段。

旧写法的三个风险：随机源、字符集和长度

典型旧代码会先从 math/rand 取整数，再用取模索引访问字符表。它看起来短，但随机源不是为令牌设计的；如果字符表长度不能整除取值范围，简单取模还会造成分布偏差。

const letters = "abcdefghijklmnopqrstuvwxyz0123456789"

func LegacyCode(n int) string {
    b := make([]byte, n)
    for i := range b {
        b[i] = letters[mathrand.Intn(len(letters))]
    }
    return string(b)
}

这段实现还有一个业务陷阱：调用方通常把长度写死为 8 或 12，迁移后如果继续截断新结果，等于主动减少随机空间。邀请码是给用户看的，可以另做展示层编码；登录链接、找回密码令牌这类值则不应为了“好看”降低熵。

最小迁移写法：让标准库负责生成

支持该 API 的项目可以直接替换生成函数，并把唯一性留给数据库约束和有限重试。生成函数本身不需要先转成字节，也不需要自己维护字符表。

package invite

import "crypto/rand"

func NewCode() string {
    return rand.Text()
}

如果产品要求固定展示长度，先明确这是“展示编号”还是“安全令牌”。对安全令牌，不建议随意截断；对展示编号，可以把 rand.Text 作为高熵原料，再经过明确记录的编码或分组规则处理，并重新计算碰撞预算。

回归验收：别只测能不能生成

迁移后的测试至少覆盖四件事：返回值非空、字符集符合预期、字段能被完整保存、重复值能按数据库约束重试。随机 API 不适合用“等于某个固定字符串”做断言，测试应验证性质。

func TestNewCode(t *testing.T) {
    code := NewCode()
    if len(code) != 26 {
        t.Fatalf("unexpected code length: %d", len(code))
    }
    for _, r := range code {
        if !(r >= 'A' && r = '2' && r 

长度断言要和项目使用的 Go 版本、官方文档以及字段设计保持同步。官方实现也说明未来版本可能为了维持随机性而返回更长文本，所以数据库字段不要只留 26 个字符；迁移时把长度预算写进 schema 评审和接口契约。

上线前的迁移清单

• 确认 go.mod、CI 镜像和生产构建机使用支持 crypto/rand.Text 的 Go 版本。
• 删除或隔离 math/rand 生成安全令牌的路径，避免新旧实现按业务分支混用。
• 检查数据库唯一索引、字段长度、日志脱敏和接口返回字段，不要把完整令牌写进普通日志。
• 保留一次回滚方案：旧版本仍能编译，或者在发布前完成全量构建验证。
• 用性质测试验证字符集和长度，用集成测试验证重复值时的有限重试，不用固定样本验证随机性。

常见问题

crypto/rand.Text 生成的是数字还是字母？

当前实现使用 RFC 4648 Base32 字母表，包含大写英文字母和数字 2 到 7，不是纯数字，也不包含小写字母。

它能直接替代 UUID 吗？

它适合短令牌和邀请码，但不自动表达时间、版本或资源类型。需要 UUID 语义时，仍应使用适合 UUID 的方案。

邀请码要不要截成 8 位？

只有在明确计算过碰撞预算并接受重试成本时才考虑。登录令牌、找回链接等安全值不建议为了展示长度截断。

旧 Go 版本不能调用怎么办？

用构建标签或兼容包隔离新旧实现，并在 CI 中同时编译支持范围内的最低版本和目标版本。

结语：把随机性迁移和数据契约一起改

crypto/rand.Text 的价值不只是少写几行字符映射代码，而是把安全随机源和可读字符集交给标准库维护。真正稳妥的迁移要同时更新版本门槛、字段长度、唯一约束、日志策略和回归检查，这样新 API 才不会在上线后被旧的长度假设拖回去。