Go 问答：io.LimitedReader 读完上限后如何判断真实 EOF：N 字节边界与底层读取

处理上传流或拆分协议体时，io.LimitedReader 很容易被误读成“读到文件末尾”。它真正做的是给底层 io.Reader 套一个 N 字节预算：预算用完后，包装器才会在下一次读取中返回 io.EOF。所以判断结果时，要把“限制到头”和“底层真的没有数据”分开。

io.LimitedReader 的 EOF 只能说明它的 N 已经耗尽或底层返回了结束信号，不能单独证明底层输入恰好在这里结束；需要同时观察已读字节数和剩余预算。

先看清 LimitedReader 的两条结束路径

io.LimitReader(src, n) 返回一个 io.Reader。标准库实现把它交给 LimitedReader.Read：如果 N ，立即返回 0, io.EOF；否则把本次缓冲区裁剪到不超过 N，再调用底层 R.Read，最后用实际读取的字节数扣减 N。

这意味着 EOF 有两种来源：限制预算已经归零，或者底层 R 先返回了结束信号。代码先记录 n 和 err，再检查 limited.N，边界就不会混在一起。

package main

import (
    "fmt"
    "io"
    "strings"
)

func main() {
    limited := &io.LimitedReader{R: strings.NewReader("abcdef"), N: 4}
    buf := make([]byte, 4)

    n, err := limited.Read(buf)
    fmt.Printf("first: data=%q n=%d err=%v remaining=%d\n", buf[:n], n, err, limited.N)

    n, err = limited.Read(buf)
    fmt.Printf("second: n=%d err=%v remaining=%d\n", n, err, limited.N)
}

第一轮会读出 abcd，err 通常为 nil，但 remaining 已经是 0；第二轮才返回 io.EOF。这也是“数据已读完”和“收到 EOF”不总在同一次调用发生的原因。

用剩余 N 判断是截断还是正常封顶

如果输入只有 ab，但限制仍设为 N: 4，第一次读取得到两个字节并收到 io.EOF，此时 limited.N 仍大于 0。这说明底层数据提前结束，不能把它当成“完整读满四字节”。

func readExactlyFour(src io.Reader) ([]byte, error) {
    limited := &io.LimitedReader{R: src, N: 4}
    data, err := io.ReadAll(limited)
    if err != nil {
        return nil, err
    }
    if limited.N != 0 {
        return nil, fmt.Errorf("short input: remaining=%d", limited.N)
    }
    return data, nil
}

这个检查适合“最多读取四字节，但必须刚好拿到四字节”的场景。若业务只是防止单次请求超过四字节，那么剩余 N 大于 0 并不是错误，应该按业务语义决定是否接受短输入。

三个常见误区

把 LimitReader 当成校验器

io.LimitReader 只负责限制读取量，不会告诉你后面是否还有第 5 个字节。若要拒绝超长输入，可以把限制设为“允许长度加一”，读出后检查结果是否超过业务上限。

只比较 err 是否为 EOF

只看 err == io.EOF 无法区分“正好读满上限”和“底层提前结束”。同时保留 n、limited.N，必要时再检查底层数据源的协议状态。

把 ReadAll 的 EOF 当成失败

io.ReadAll 成功读到流尾时返回的错误是 nil，不是 io.EOF。因此这里应先检查返回错误，再按 limited.N 判断是否读满约定长度。

相关问题

LimitedReader 会关闭底层文件吗？

不会。它只实现读取包装，不提供关闭动作；文件或网络响应体仍由创建它的代码负责关闭。

读满 N 后还能从原 Reader 继续读吗？

可以，限制器只消费前 N 个字节，剩余数据仍留在底层 Reader 中；但要注意缓冲层可能已经预读了更多数据。

什么时候该用 io.ReadFull？

当目标是必须读满固定长度，并且希望短输入得到 io.ErrUnexpectedEOF 等明确结果时，io.ReadFull 通常比手动维护 N 更直接。

小结

记住一条就够：LimitedReader.N == 0 代表限制额度已用完，EOF 只代表这次读取链路结束。把剩余额度、实际字节数和错误一起记录，才能准确处理完整输入、短输入与超长输入。