Go io.MultiWriter 一个目标写失败后还会继续写其他目标吗

用 Go 开发时经常会用到 io.MultiWriter 把同一份数据同时往多个目标里写，它在途中某个目标写失败后，并不会继续写剩下的其他目标，遇到第一个错误就直接停掉了。

io.MultiWriter 按初始化时传入的写入器顺序逐个执行写入逻辑，只要任意一个 Writer 返回 error，就会立刻中止后续所有写入操作，返回当前已经写入成功的字节数，以及该次错误的具体信息。

会停止。io.MultiWriter 不是“尽力把数据广播给所有目标”的容错组件，而是按传入顺序逐个调用 io.Writer.Write：前一个目标成功，才会继续下一个；某个目标返回错误，当前这次写入立即结束，后面的目标不会再被调用。

io.MultiWriter 的核心规则：按列表顺序写，遇错就停

官方接口文档把它描述成类似 Unix tee 的 Writer，但这里的“复制”是一次写调用里的串行复制，不是并发广播。下面把三个目标放进同一次写操作，观察调用记录。

package main

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

type traceWriter struct {
    name  string
    calls *[]string
    err   error
}

func (w traceWriter) Write(p []byte) (int, error) {
    // 记录调用顺序；err 非 nil 时模拟该目标拒绝本次写入。
    *w.calls = append(*w.calls, w.name)
    if w.err != nil {
        return 0, w.err
    }
    return len(p), nil
}

func main() {
    calls := make([]string, 0, 3)
    stopErr := errors.New("archive target unavailable")
    dst := io.MultiWriter(
        traceWriter{name: "audit", calls: &calls},
        traceWriter{name: "archive", calls: &calls, err: stopErr},
        traceWriter{name: "metrics", calls: &calls},
    )

    n, err := dst.Write([]byte("event-1"))
    fmt.Println(n, err, calls)
}

这个示例的关键不是输出文字，而是 calls 的顺序：它只会记录 audit 和 archive，不会出现 metrics。因此，如果第三个目标承担必须落盘的任务，把它放在一个可能失败的目标之后，不能获得“即使前面失败也继续写”的效果。

显式错误、短写与 io.ErrShortWrite 要分开看

io.Writer 的契约要求：当 n 时必须返回非 nil 错误。MultiWriter 会把每个目标的返回值纳入同一套判断；目标完整写入才会进入下一个目标。

工程上最容易忽略的是第二行和第三行的差异：错误可能来自目标本身，也可能来自不符合 Writer 契约的短写。两种情况都意味着后续 Writer 没有被可靠地写入，不能只看 err == nil 就提交“广播成功”。

日志、文件和网络目标该怎样排列

如果组合是“审计文件 + 归档网络流 + 指标记录”，先确定一次写入的成功标准，再排序。通常应把最不能缺失、失败后需要立即感知的目标放前面；把允许丢失且不会影响主流程的观测目标放后面。这样做不能改变 MultiWriter 的停止语义，但能让失败更早暴露。

如果业务要求“某一路失败仍继续写其他路”，就不要把 io.MultiWriter 误当成这个组件。可以为每个目标单独调用 Write，分别记录 n 和 err，再定义聚合错误、重试和补偿策略；这已经是业务级容错广播器，边界不应藏在一个普通 Writer 组合器里。

检查清单：判断后续目标是否真的写到了

• 确认目标顺序是否与 MultiWriter 参数顺序一致。
• 给每个 Writer 记录调用次数，区分“未调用”和“调用后失败”。
• 同时检查 n 与 err，不要只判断错误是否为 nil。
• 需要独立容错时，改用显式循环并定义聚合结果。

相关问题

io.MultiWriter 会并发写多个目标吗？

不会。每次写入按列表顺序逐个调用；如果需要并行，需要自行设计并发、超时和错误聚合。

第一个目标成功、第二个目标失败时，第三个目标有可能已经写入吗？

对同一次 Write 调用，按标准语义不会。第二个目标返回错误或短写后，当前调用结束，第三个目标不会继续执行。

只想记录日志失败，不想影响主写入怎么办？

不要直接把它放进要求全成功的 MultiWriter 链路；将日志写入单独处理，并明确记录丢失、重试或降级状态。