Go io.CopyN 读不满时为什么返回 EOF：短读、剩余字节与错误判断

用 Go 处理上传分片、文件头或固定长度协议时，io.CopyN 很容易被误读成“只要没复制够就返回一个普通错误”。实际语义更精确：它会先返回已经写入的字节数；当源数据在目标长度之前结束时，错误通常是 io.EOF。所以判断结果不能只看 err == nil，还要把 n 和期望长度放在一起看。

io.CopyN(dst, src, want) 成功的条件是返回的 n == want 且错误为 nil；如果源数据不足，n 仍然有价值，io.EOF 表示“提前结束”，不是“已经复制完成”。

io.CopyN 的结果为什么不是“复制失败”

先用一段只有 5 个字节的输入，要求复制 8 个字节：

src := strings.NewReader("hello")
var dst bytes.Buffer
n, err := io.CopyN(&dst, src, 8)
fmt.Printf("n=%d err=%v data=%q\n", n, err, dst.String())
// n=5 err=EOF data="hello"

这里的 n=5 表示写入目标的有效数据确实有 5 个字节；EOF 说明源 Reader 已经结束，剩余 3 个字节无法凭空补齐。把它当作普通失败并丢弃 n，会让日志失去判断“收到多少数据”的关键信息。

固定长度读取应该怎样判断

对于“必须拿到 8 个字节才能解析”的场景，建议把成功条件写完整：

const want = 8
n, err := io.CopyN(&dst, src, want)
if err != nil {
    return fmt.Errorf("copy fixed block: got %d of %d bytes: %w", n, want, err)
}
if n != want {
    return fmt.Errorf("short copy: got %d of %d bytes", n, want)
}

通常 io.CopyN 在未达到目标长度时已经会给出非空错误，因此第一层就能拦住短读；这里的 EOF 分支 就是“输入提前结束”的处理路径。保留 n != want 这一层仍然值得，因为它把协议前提明确写在代码里，也方便以后替换 Reader 或测试桩。

如果需求是“从 Reader 读满固定长度到内存”，可以直接使用：

buf := make([]byte, 8)
n, err := io.ReadFull(src, buf)
if err != nil {
    return fmt.Errorf("read fixed block: got %d of %d bytes: %w", n, len(buf), err)
}

io.ReadFull 表达的是读取语义；io.CopyN 更适合把数据流直接送到 Writer。两者都保留实际完成量，调用方仍应根据协议决定是重试、丢弃还是记录残片。

io.LimitReader 能不能替代 io.CopyN

io.LimitReader 只负责把可读上限限制为 n，并不承诺源数据一定够长。下面的组合仍然要检查复制结果：

limited := io.LimitReader(src, want)
n, err := io.Copy(&dst, limited)
if err != nil || n != want {
    return fmt.Errorf("incomplete input: got %d of %d bytes: %w", n, want, err)
}

它适合把“不允许读取超过上限”和“复制数据”分开表达；若只是复制固定长度，io.CopyN 更短，也直接保留了提前结束的错误。

三个容易写错的判断

• 只写 if err != nil { return err }，却没有把 n 写入日志，排查分片截断时看不到实际收到的长度。
• 把 io.EOF 当作成功标记。对固定长度协议而言，只有 n == want 且 err == nil 才是完整成功。
• 把 io.CopyN 当成重试器。Reader 已经结束时，重试同一个 Reader 通常不会得到新数据，应该回到上层重新取得输入。

相关问题

io.CopyN 复制刚好 N 个字节时会返回 EOF 吗？

正常情况下不会。达到目标长度后复制就完成了，调用方应看到 n == N 且 err == nil。

短读时已经拿到的数据应该保留吗？

取决于协议。可恢复的分片可以保存并等待后续数据；不可恢复的固定头或完整记录则应丢弃并记录 n，避免把残片当完整数据解析。

什么时候优先使用 io.ReadFull？

目标是填满一个固定大小的字节切片时优先使用它；目标是把固定长度直接写入另一个 Writer 时，io.CopyN 更贴合意图。

最小验证清单

写完固定长度读取后，用“刚好够、明显不足、Reader 返回底层错误”三组输入测试。每组都记录 n、err 和目标内容，再决定是否重试或拒绝数据。这样既不会误吞 io.EOF，也不会把短读误当成空结果。