Go bufio.Reader ReadSlice 返回 ErrBufferFull 时怎么拼接长行

用 bufio.Reader.ReadSlice 读日志、协议帧或导入文件时，只要一行长度超过 Reader 的内部缓冲区，就会拿到 bufio.ErrBufferFull。这不是数据损坏，也不是应该立刻退出的致命错误，而是告诉你“当前片段还没有遇到分隔符”。正确做法是先把这次返回的字节复制到自己的切片，再继续读取，直到 err == nil；如果输入在换行前结束，还要保留已拼接的数据并处理 io.EOF。

ErrBufferFull 到底说明了什么

ReadSlice(delim) 会在内部缓冲区里寻找第一个 delim。找到时返回包含分隔符的切片和 nil；缓冲区先被填满时，则返回当前剩余片段和 ErrBufferFull。因此，一次返回值不是“一整行”，而是长行的一段。

还有一个容易忽略的生命周期：返回切片指向 Reader 自己的缓冲区，下一次读取可能覆盖它。下面的关系图把调用方的累积切片、Reader 缓冲区和错误边界放在一起，便于理解为什么必须先 append 再继续调用。

用 append 把多个片段拼成完整长行

核心是把“片段是否结束”和“读取是否出错”分开判断。ErrBufferFull 继续循环；nil 表示已经读到分隔符；io.EOF 可能伴随最后一段没有换行的数据。

package main

import (
    "bufio"
    "errors"
    "io"
)

// readLongLine 拼接超过 Reader 缓冲区的内容，并保留 EOF 前的最后一段。
func readLongLine(r *bufio.Reader, delim byte) ([]byte, error) {
    var line []byte // 由调用方持有，避免引用 Reader 的复用缓冲区
    for {
        part, err := r.ReadSlice(delim)
        line = append(line, part...) // 必须在下一次 I/O 前复制当前片段

        if err == nil {
            return line, nil // part 以 delim 结尾，整行已经收束
        }
        if errors.Is(err, bufio.ErrBufferFull) {
            continue // 只是片段边界，继续读取同一行
        }
        if errors.Is(err, io.EOF) {
            if len(line) > 0 {
                return line, io.EOF // 最后一行没有 delim，数据仍然有效
            }
            return nil, io.EOF // 没有剩余数据，表示输入真正结束
        }
        return nil, err // 非 EOF 错误不能被拼接逻辑吞掉
    }
}

这个函数把“返回数据”和“流结束”同时交给调用方决定：收到非空数据与 io.EOF 时，可以先处理这一行，下一次再结束；如果业务要求每行都必须有换行符，则应把这类结果视为格式错误，而不是静默补上换行。

三种读取方式该怎么选

如果你不需要复用 Reader 缓冲区、也不需要逐段解析，直接使用 ReadBytes('\n') 往往更短。只有在协议需要边读边判断、或者想控制内存策略时，才值得承担 ReadSlice 的生命周期细节。

常见问题

遇到 ErrBufferFull 时能不能直接丢掉这段？

不能。它通常是长行的前半段，丢弃后再读会把一行拆坏。除非业务明确要跳过整行，否则应 append 后继续。

ReadSlice 返回的片段需要手动 copy 吗？

需要保存跨次读取的数据时要复制；append(line, part...) 已经完成复制。若只在当前调用内立即消费，也不能跨过下一次 I/O 继续引用它。

最后一行没有换行符算错误吗？

取决于格式约定。读取层可以返回已拼接内容和 io.EOF，上层再决定是否接受无终止符的最后一行。

结论：处理 ReadSlice 长行时，关键不是把 Reader 缓冲区调得足够大，而是把每个返回片段及时复制到调用方拥有的累积区，并把 ErrBufferFull、分隔符和 EOF 分别解释。