Go io.MultiWriter怎样把一次写入分发到多个目标为什么结果为空或不符合预期

我第一次用 io.MultiWriter 是为了把一份审计文本同时写进内存缓冲区和文件。代码看起来只是把几个目标放进一个函数，实际排查时却很容易遇到两个现象：调用成功了，但从错误的对象读取，结果像是空的；或者前一个目标出错后，后面的目标没有任何内容。

先给结论：io.MultiWriter 返回的是一个组合后的 io.Writer，它不会替你保存一个可读取的总缓冲区。每次 Write 会按传入顺序写入各个目标；某个目标返回错误后，本次写入立即停止，并把错误交给调用方。

官方文档入口：https://pkg.go.dev/io

io.MultiWriter 返回的到底是什么

它的签名是 io.MultiWriter(writers ...io.Writer) io.Writer。也就是说，返回值的职责仍然是接受 Write([]byte)，而不是提供 String()、Bytes() 或“读取全部分发结果”的方法。

所以排查“结果为空”时，第一件事不是读取 MultiWriter 本身，而是回到传入的目标对象。下面这张图只表达对象和接口的静态关系，不是运行截图或执行证据。

还有一个常见误区是把“分发”理解成“并发”。官方定义是逐个写入列出的 Writer；如果业务需要某个目标慢了也不影响其它目标，就不能只靠 MultiWriter 解决。

怎样把同一份数据写进多个目标

内存目标和文件目标都实现了 io.Writer，可以先组合，再把这个组合 Writer 交给 io.WriteString、io.Copy 或自己的写入函数：

package main

import (
    "bytes"
    "fmt"
    "io"
    "os"
    "strings"
)

func fanout() error {
    var text strings.Builder
    var memory bytes.Buffer

    // 文件是额外的落盘目标；创建失败时不要继续组装 Writer。
    file, err := os.Create("audit.log")
    if err != nil {
        return err
    }
    // 退出函数前关闭文件，避免只看到内存结果却遗漏文件资源。
    defer file.Close()

    // 传入三个具体 Writer，MultiWriter 只负责组合它们的 Write 方法。
    writer := io.MultiWriter(&text, &memory, file)

    // 一次 Write 会被依次交给三个目标；必须保留返回值判断错误。
    n, err := io.WriteString(writer, "request accepted\n")
    if err != nil {
        return err
    }
    if n == 0 {
        return fmt.Errorf("没有写入任何字节")
    }

    // 结果从原始目标读取，而不是从 writer 读取。
    fmt.Print(text.String())
    fmt.Print(memory.String())
    return nil
}

这里的关键不是把目标数量写成三个，而是保证每个目标的生命周期和错误都可控。strings.Builder、bytes.Buffer 都使用指针传入，后面读取时也读取原变量。文件则要单独负责关闭。

为什么会出现空结果或只写入了一部分

如果目标是值而不是指针，首先要确认它是否真的实现了 io.Writer。很多缓冲类型的写入方法依赖指针接收者；即使代码经过封装后成功拿到了 Writer，也不要把组合 Writer 当作结果容器。

第二个边界是错误位置。MultiWriter 按传入顺序处理目标：前面的 Writer 返回错误时，后面的 Writer 不会继续接收这一次数据。因此，“第一个目标有内容、第二个目标为空”不一定是第二个目标的读取问题，也可能是第一个目标已经让本次 Write 提前结束。

调用方至少要保留 n 和 err。如果忽略错误，只打印某个目标的内容，就很难判断是“没有写入”还是“写入在中途停止”。io.Writer 的约定也是：返回的字节数少于输入长度时，应同时返回非空错误。

什么时候不该只用 MultiWriter

如果所有目标都必须拿到同一份数据，并且前一个目标失败就应该让整个操作失败，MultiWriter 很合适：日志同时写内存和文件、把内容同时送到两个稳定的 Writer，都是清晰的组合场景。

如果目标之间要互不影响、需要分别重试，或要并发写入，就应该为每个目标设计独立的错误记录和生命周期。不要把“多个 Writer”误当成隔离的任务队列；MultiWriter 只提供一个组合 Writer 和明确的顺序错误语义。

最后可以按这个顺序排查：先看是否从具体目标读取，再看目标是否以正确的指针形式传入，然后检查 Write 返回的 n 和 err，最后确认错误目标在列表中的位置。

相关问题

io.MultiWriter 会自动缓存所有写入内容吗？

不会。它只是把写入转交给列出的 Writer；需要读取内容时，读取你自己创建的 Builder、Buffer 或其它具体目标。

某个 Writer 出错后还能继续写其它目标吗？

同一次 Write 不会继续越过出错目标。若业务要容忍单个目标失败，需要自己拆分调用并分别记录结果。