当前位置：首页 > 文章列表 > Golang > Go问答 > Go io.Copy 报 short write 是读端还是写端出错

Go io.Copy 报 short write 是读端还是写端出错

来源：17golang原创 2026-09-06 06:56:37 0浏览收藏

如果 io.Copy 返回 short write，先查目标 io.Writer，不是先怀疑读端。Go 对 io.ErrShortWrite 的定义是：写入方接收的字节数少于请求数量，却没有返回明确错误。也就是说，复制过程中通常已经从 Reader 读到了数据，真正不符合契约的是 Writer 的 Write 返回值。

判断顺序可以很简单：先看 written 和 err，再检查 Writer 是否出现 n 且 err == nil。只有当错误是自定义读取错误或网络读取错误时，才把排查重点放到 Reader。

要点速览

io.ErrShortWrite 代表写端少写且没有显式错误，不代表 Reader 读少了。
真正的 Reader 错误通常会原样返回，written 记录已经成功复制的字节数。
io.Copy 可能调用 src.WriteTo 或 dst.ReadFrom，CopyBuffer 不一定强制走缓冲区。

先看 written 和 error 的组合

io.Copy 返回两个关键值：已写入的字节数和复制中遇到的第一个错误。正常读到 EOF 不算失败，成功时 err 是 nil；如果目标 Writer 只写了一部分却返回空错误，复制逻辑才会把它归一成 io.ErrShortWrite。

返回结果	优先怀疑	下一步
`errors.Is(err, io.ErrShortWrite)`	目标 Writer 契约	检查 Write 的 n 和 err
自定义 Reader 错误	源数据或读取链路	记录 Reader 类型与错误链
`written > 0` 且有错误	部分复制后失败	决定是否清理半成品或断点续写
`err == nil`	复制成功	不要把 EOF 当成失败

Go io.Copy 中 Reader、Writer 与 io.ErrShortWrite 返回关系示意图 — 图1：io.Copy 的返回关系中，short write 指向目标 Writer 的少写契约，而不是 Reader 的普通读取错误。

核对 Writer 的 Write 契约

io.Writer 要求：Write(p) 返回的 n 必须在 0 到 len(p) 之间；只要 n ，就必须同时返回非空错误。下面这个 Writer 故意违反了约定，所以 io.Copy 会得到 short write：

package main

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

// brokenWriter 模拟只接收一部分数据却返回 nil 的错误实现。
type brokenWriter struct{}

func (brokenWriter) Write(p []byte) (int, error) {
    if len(p) == 0 {
        return 0, nil
    }
    return 1, nil // 少写但不报错，违反 io.Writer 契约
}

func main() {
    written, err := io.Copy(brokenWriter{}, strings.NewReader("abcdef"))
    fmt.Println(written, err)
    fmt.Println(errors.Is(err, io.ErrShortWrite)) // true
}

这里的根因在 brokenWriter.Write，不是 strings.Reader。真实项目中常见的类似问题包括自定义压缩 Writer、限流 Writer、分片上传适配器，以及把底层网络返回值错误转换的包装层。修复方式不是忽略 io.ErrShortWrite，而是让 Writer 在少写时返回具体错误，或者在内部正确处理剩余切片。

用 Reader 错误做对照

如果 Reader 自己返回一个错误，io.Copy 通常会保留这个错误。Reader 允许一次读取返回 n > 0 和错误，调用方要先处理这批数据；因此看到 written 大于零，并不能直接说明是 Writer 出错。

type failReader struct {
    sent bool
}

func (r *failReader) Read(p []byte) (int, error) {
    if r.sent {
        return 0, errors.New("source stream interrupted") // 模拟源端中断
    }
    copy(p, "hello")
    r.sent = true
    return 5, nil
}

func copyFromSource() error {
    var dst bytes.Buffer
    written, err := io.Copy(&dst, &failReader{})
    if err != nil {
        return fmt.Errorf("copy %d bytes from source: %w", written, err) // 保留原始错误
    }
    return nil
}

排查时可以用 errors.Is 或 errors.As 判断错误链，不要只比较字符串。若错误是连接关闭、超时或业务 Reader 返回的自定义错误，应沿着 Reader 的包装层继续查；若错误能匹配 io.ErrShortWrite，优先回到 Writer 的写入契约。

别忘了 io.Copy 可能绕过缓冲区

io.Copy 并不保证每次都使用内部缓冲循环。官方实现会优先检查源端是否实现 io.WriterTo，否则再检查目标端是否实现 io.ReaderFrom；只有两者都没有时，才使用普通的缓冲复制路径。即使调用 io.CopyBuffer，这两个能力存在时提供的 buffer 也可能不参与复制。