Go crypto/tls Config.Rand 被弃用后如何做确定性测试

我第一次把 Go 1.27 的 TLS 测试迁过去时，最先注意到的是 tls.Config.Rand 的弃用提示。真正需要改的不是把字段换成另一个随机数对象，而是把“生产配置”和“测试随机源”分开：生产环境让 Rand 保持 nil，测试函数使用 testing/cryptotest.SetGlobalRandom。这样既顺应新 API，也不会把测试专用控制带进线上握手。

官方资料：https://go.dev/doc/go1.27、https://pkg.go.dev/testing/cryptotest@go1.27.3

先看清 Config.Rand 到底该放在哪里

Go 1.27 的 crypto/tls 文档把 Config.Rand 标记为弃用：生产代码应留空，TLS 会使用 crypto/rand 的安全随机读取器。更重要的是，官方还提醒并不是所有 TLS 配置都保证使用 Rand，所以它本来就不是一个可靠的“全局随机注入开关”。

我现在会把生产配置写得很普通，只设置证书、服务器名和协议边界，不再为了测试方便给它塞一个固定 Reader：

func clientConfig(serverName string, certs []tls.Certificate) *tls.Config {
    return &tls.Config{
        // 生产配置不注入测试随机源，Rand 保持 nil。
        ServerName:  serverName,
        Certificates: certs,
        MinVersion:  tls.VersionTLS12,
    }
}

测试需要可重复随机流时，应该在测试作用域里控制默认随机源，而不是改变应用构造函数的生产语义。

用 SetGlobalRandom 替代手工注入

testing/cryptotest.SetGlobalRandom 接收测试对象和一个 uint64 seed，为当前测试安装确定性的密码学随机源。它会影响 crypto/rand 以及 crypto 包内部的隐式随机源，并通过测试清理动作恢复之前的 Reader。对 TLS 握手测试来说，这比让业务代码携带一个测试专用的 io.Reader 更贴近实际调用路径。

func TestTLSHandshakeUsesStableRandom(t *testing.T) {
    // 该测试不能调用 t.Parallel，因为随机源是进程级测试状态。
    cryptotest.SetGlobalRandom(t, 42)

    client := &tls.Config{
        // ServerName 用于证书选择；随机源不再从 Config.Rand 注入。
        ServerName: "example.test",
        MinVersion: tls.VersionTLS13,
    }

    // 这里接入测试用的本地连接和证书，并断言握手结果。
    if err := runHandshake(client); err != nil {
        t.Fatalf("TLS handshake failed: %v", err)
    }
}

同一个测试里可以再次调用 SetGlobalRandom 重置随机流或更换 seed，但不要把它当成局部依赖：官方文档明确说它影响整个进程，因此并行测试或带并行祖先的测试都不能使用。

确定性不等于固定每一组密码学输出

迁移后最容易留下的误区，是把“随机源可重复”理解成“所有 TLS 输出永远不变”。密码学算法如何消耗随机数并没有被承诺为跨版本稳定；Go 官方因此建议不要把某段密文字节、密钥派生结果或完整握手编码当成长期快照。更稳妥的断言是：

我会保留的迁移清单

• 搜索测试和生产代码中的 Config.Rand，生产配置优先删除赋值，测试代码改到 SetGlobalRandom。
• 检查测试是否调用过 t.Parallel，或是否处在并行祖先下；有的话拆出串行测试边界。
• 把断言从“固定密码学字节”收窄到协议结果、错误条件和可复现的失败路径。
• 如果测试依赖 FIPS 140 加密模块，还要注意官方文档说明的兼容限制，不能假设所有构建模式都支持该入口。

常见问题

Config.Rand 被弃用后会立刻不能编译吗？

不会，弃用首先是迁移信号。问题在于它不再适合作为生产配置中的测试控制点，也不能保证覆盖所有 TLS 配置。

SetGlobalRandom 能放进 t.Parallel 的测试吗？

不能。它影响整个测试进程，官方明确禁止在并行测试或有并行祖先的测试中使用。

为什么用了固定 seed，升级 Go 后结果仍可能变化？

固定 seed 只让当前实现的随机流可重复；密码学算法消耗随机数的方式可能随实现或版本变化，所以应固定行为断言，而不是固定所有密码学字节。