Go io.LimitReader 读完后为什么不是原始 EOF

如果用 io.LimitReader 读取前 N 个字节，读到末尾后得到 io.EOF，这个 EOF 不一定来自原始 reader。它可能只是限制器在剩余配额归零后主动发出的结束信号。Go 的实现把两种情况都统一成了 io.EOF，所以不能只看 error 值下结论。

先把 EOF 语义分成两种终点

io.LimitReader 返回的底层类型是 *io.LimitedReader。它维护一个剩余数量 N：每次读取后用实际返回的字节数减少 N；如果调用时 N ，直接返回 0, io.EOF，不会再访问原始 reader。

例如限制值是 3，第一次读到 abc 后 N 变成 0。下一次读取得到 EOF，表示“这个受限视图没有更多字节”，并不等于原始输入已经被读完。原始数据即使还有 def，也不会通过这个 LimitedReader 暴露出来。

用读取字节数判断是否撞到上限

排查时先累计 n，再看它与限制值的关系。不要把 err.Error() 当作判断依据，因为人工边界和底层自然结束都使用同一个 io.EOF。

package main

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

func main() {
    // 限制器只允许交付前三个字节，原始 reader 的剩余内容不会出现。
    limited := io.LimitReader(strings.NewReader("abcdef"), 3)
    data, err := io.ReadAll(limited)

    // 字节数等于限制值，只能证明读满边界，不能证明源数据结束。
    fmt.Printf("data=%q bytes=%d eof=%t\n", data, len(data), err == io.EOF)
}

若限制值为 10，而最终只读到 6 个字节后 EOF，可以判断底层输入在达到上限前结束了。若读到 10 个字节，则只能判断“限制边界命中”。这时源数据恰好 10 字节和源数据超过 10 字节，在受限 reader 这一层看起来完全相同。

需要精确区分时保留一个探测字节

如果协议要求判断“第 N 个字节后是否还有下一段”，不要把 LimitReader 的 EOF 当成原始 EOF。可以让受限 reader 负责读取主体，再从同一个原始 reader 读取一个字节作为探测；如果探测成功，说明后面还有数据，之后要把这个字节和原始 reader 一起交给下一阶段。

// probeAfterLimit 只在业务确实需要知道边界后是否还有数据时使用。
func probeAfterLimit(src io.Reader, limit int64) ([]byte, bool, error) {
    // 先消费最多 limit 个字节，避免主体读取越过协议边界。
    body, err := io.ReadAll(io.LimitReader(src, limit))
    if err != nil {
        return nil, false, err
    }

    var one [1]byte
    // 额外读取一个字节；成功说明原始 reader 仍有后续内容。
    n, probeErr := src.Read(one[:])
    if n == 1 {
        return append(body, one[0]), true, nil
    }
    if probeErr == io.EOF {
        return body, false, nil
    }
    return body, false, probeErr
}

这个示例把探测字节暂时拼到返回值中，实际项目也可以把它放入 bufio.Reader，或交给下一帧解析器。重点不是“多读一个字节”本身，而是保留原始 reader 的观察机会；只拿 LimitedReader 返回的 EOF，无法获得这条信息。

把固定长度和流式读取分开设计

三种需求要分开处理：只想最多读取 N 字节并截断，使用 io.LimitReader；要复制固定 N 字节，可以使用 io.CopyN；协议明确要求必须得到完整 N 字节，则用 io.ReadFull，它会把提前结束报告为 io.ErrUnexpectedEOF，语义更清楚。

最后可以用一个简单清单复核：是否真的需要区分两种 EOF；读取总量是否小于限制值；是否应该调用固定长度 API；边界后的探测字节由谁保存。这样，io.LimitReader 的 EOF 就不会被误解成“原始流已经结束”。

相关问题

io.LimitReader 会关闭底层文件吗？

不会。它只是包装 io.Reader，没有统一的关闭操作；文件或网络连接仍由创建它的代码负责关闭。

读满限制值后能判断源数据刚好结束吗？

不能。读满只说明受限视图到达边界；要判断后面是否还有数据，需要继续观察原始 reader 或使用协议层的长度、分隔符信息。