crypto/rand读取失败如何处理

Go 里遇到 crypto/rand 读取失败，先不要给 rand.Read 外面包一个普通的 if err != nil。rand.Read 的契约是填满整个切片且不返回错误；底层 Reader 出错时，标准库会让进程不可恢复地终止。需要记录、重试或向上层返回错误时，应直接使用 io.ReadFull(rand.Reader, b)；需要范围整数时用 rand.Int，让错误沿调用链返回。

绝大多数`crypto/rand`读取错误都来自底层系统调用异常，优先保证随机源的密码学安全性，不要随便用伪随机数直接替换安全随机源。

先区分三个读取入口的错误语义

crypto/rand.Reader 是并发安全的全局 io.Reader，默认连接操作系统提供的安全随机 API。crypto/rand.Read 在内部按“必须填满”处理，并且把 Reader 的错误视为无法继续生成安全随机数据的致命条件。因此下面的写法看似检查了错误，实际上没有可处理的错误返回：

buf := make([]byte, 32)
// rand.Read 的契约是填满 buf；这里的 err 不会成为业务层的恢复入口。
n, err := rand.Read(buf)
if err != nil {
    // 这条分支不是处理底层 Reader 故障的可靠方案。
    return fmt.Errorf("生成随机字节失败: %w", err)
}
_ = n

真正需要保留错误模型时，把读取器交给 io.ReadFull。它会持续读取直到填满切片，或者把底层错误返回给调用方；这正是业务层决定重试、失败或切换流程所需要的边界。

固定长度随机字节用 io.ReadFull 接管错误

密钥材料、一次性令牌或会话随机数通常先确定长度，再填充字节。可以把这段策略封装成小函数，让调用方只看到“得到完整字节”或“得到带上下文的错误”两种结果：

package token

import (
    "crypto/rand"
    "fmt"
    "io"
)

func SecureBytes(size int) ([]byte, error) {
    // 长度由业务约束，避免负数或零长度掩盖配置错误。
    if size 

不要用循环调用 rand.Read 来“等待它恢复”，也不要用普通伪随机源替代安全随机源。若确实需要重试，应在 SecureBytes 的上层设定次数、超时和告警；重试不能改变随机源已经不可用这一事实。

范围整数和随机文本不要手工取模

范围整数直接使用 rand.Int，它会返回均匀分布的 [0, max) 结果，并把 Reader 错误传给调用方；同时要保证 max 大于零。需要密钥、口令或其他文本时，较新的 Go 标准库提供 rand.Text，调用方不必自己拼字符集和处理取模偏差。

func IssueCode(max int64) (int64, error) {
    // rand.Int 的上界是开区间；max 

手工写成 byteValue % max 会在取值空间不能被 max 整除时引入偏差。随机数据的接口选择应先看输出类型，再看错误是否必须由业务接管。

生产默认安全源，测试边界注入失败 Reader

读取失败难以依赖真实操作系统环境稳定复现，测试可以在单个用例边界临时替换 rand.Reader，验证包装后的错误是否返回。替换全局变量会影响并发测试，所以要串行执行并在 t.Cleanup 中恢复；生产代码仍使用默认 Reader。

type failingReader struct{}

func (failingReader) Read([]byte) (int, error) {
    // 用明确错误模拟随机源不可用，不伪造部分成功数据。
    return 0, errors.New("模拟随机源故障")
}

func TestSecureBytesPropagatesError(t *testing.T) {
    old := rand.Reader
    rand.Reader = failingReader{}
    // 无论断言如何退出，都恢复全局 Reader，避免污染其他测试。
    t.Cleanup(func() { rand.Reader = old })

    _, err := SecureBytes(32)
    if err == nil || !strings.Contains(err.Error(), "读取安全随机源失败") {
        t.Fatalf("期望随机源错误，实际得到 %v", err)
    }
}

常见边界问题

为什么不能只检查 rand.Read 的返回值？因为它的公开契约已经规定不会把底层错误交给调用者；需要可恢复路径就换成 io.ReadFull 或使用会返回错误的高层函数。

失败后能否退回 math/rand？不能把非密码学伪随机源当作密钥、令牌或验证码的兜底。应该记录故障并让本次操作失败，或者按业务规则重试安全随机源。

最终可以按一个简单规则落地：固定字节选 io.ReadFull(rand.Reader, b)，范围整数选 rand.Int，随机文本选 rand.Text；只有在明确接受“底层故障导致进程终止”的边界时，才使用 rand.Read。