Go 怎样处理随机源读取不足的错误

Go 里处理安全随机字节时，先分清两个接口：crypto/rand.Read 负责把目标切片填满，文档保证它不会把随机源的读取错误作为普通返回值交给调用方；需要观察短读、EOF 或可替换随机源时，应直接使用 io.ReadFull。一旦读取没有达到目标长度，就把错误向上传递，并丢弃不完整的字节。

官方文档：https://pkg.go.dev/crypto/rand；读取接口：https://pkg.go.dev/io

为什么不能把 rand.Read 当成可恢复的 Reader 接口

crypto/rand.Read(b) 的语义很强：它会调用包内的随机源并填满 b，文档说明该函数不会返回错误；如果底层 Reader 出错，当前实现会让程序不可恢复地终止。这与普通 io.Reader 的“返回已读取数量和错误”契约不同。

所以，默认使用 crypto/rand.Reader 生成令牌、密钥或随机标识时，可以把它看成一个完整填充操作。但如果测试代码、适配层或特殊部署显式提供了一个可能失败的 io.Reader，就不要用 rand.Read 隐藏错误边界。

需要观察读取不足时，直接使用 io.ReadFull

io.ReadFull 会尝试读取恰好 len(buf) 个字节，并返回 n 与错误。它能把“没有读到任何字节”和“读到一部分后结束”区分开：前者通常是 io.EOF，后者是 io.ErrUnexpectedEOF。下面的小函数把这层语义收口成业务 API。

package randombytes

import (
    "fmt"
    "io"
)

// ReadFromSource 只在随机源完整填充后返回字节；失败时不把部分结果交给调用方。
func ReadFromSource(source io.Reader, size int) ([]byte, error) {
    if size 

这里的关键不是重试，而是完整性判断。若随机源只返回一部分字节，函数返回的切片为 nil，调用者不会误把残留内容当作完整令牌。错误中保留 n，便于日志或指标记录读取阶段，但不要把原始随机字节写入日志。

读取不足时，错误和部分缓冲区应该怎样处理

调用方应把 io.ErrUnexpectedEOF 看成“随机源没有完成约定长度”，而不是把已读数量当作成功长度。其他底层错误也应保留错误链，使用 errors.Is 判断类别，避免只依赖字符串匹配。

package randombytes

import (
    "errors"
    "fmt"
    "io"
)

// DescribeReadError 将读取失败转成可记录但不泄露随机内容的消息。
func DescribeReadError(err error) string {
    if errors.Is(err, io.ErrUnexpectedEOF) {
        return "随机源提前结束，未形成完整字节串"
    }
    if errors.Is(err, io.EOF) {
        return "随机源没有提供数据"
    }
    return fmt.Sprintf("随机源返回其他错误: %v", err)
}

io.ReadFull 的成功条件是 n == len(buf) 且 err == nil；不要只检查 n > 0。如果业务需要再次尝试，应该重新创建一次完整的缓冲区，并由上层设置明确的次数、超时和失败策略，不能在同一个部分缓冲区上继续拼接。

默认随机源和可替换随机源怎样选

生产代码通常直接传入 crypto/rand.Reader，让标准库负责选择操作系统提供的安全随机源。需要测试读取不足时，可以给函数传入一个自定义 io.Reader；这种可注入设计让错误处理能够被覆盖，但不应把测试 Reader 的失败语义误解为默认系统随机源的常态。

不要为了“修复读取不足”自行把普通伪随机数发生器当成密码学随机源，也不要把重试次数写死在底层填充函数里。随机源失败时，最重要的结果是让调用方明确知道本次没有得到完整随机字节。

常见问题

crypto/rand.Read 会返回部分字节和错误吗？

按当前官方文档，它保证填满目标切片并且不返回错误；遇到底层 Reader 错误时，处理方式不是让调用方检查部分结果。需要可恢复错误时改用显式 Reader 与 io.ReadFull。

为什么不直接循环调用 Reader 直到填满？

io.ReadFull 已经封装了短读处理，并保留 EOF 与读取数量语义。手写循环容易遗漏零字节无错误、错误链和退出条件；只有在业务确实需要特殊重试策略时，才应在更高层增加边界。

归纳起来：默认随机字节使用 crypto/rand.Read，需要可观察失败的接口使用 io.ReadFull；完整长度是成功条件，部分缓冲区只用于诊断，绝不能继续当作安全随机结果。