Go bufio.Writer Flush 后文件仍为空时如何定位关闭顺序

用 bufio.Writer 写文件时，看到 Flush() 被调用，并不代表问题已经结束。最常见的空文件原因是：写入错误没有检查、Flush 的错误被忽略，或者文件已经被 Close 后才执行 Flush。正确的生命周期是 Write → Flush → Close；如果还要求数据尽快落到稳定存储，再考虑 Sync。

一、先判断空文件到底卡在哪一层

bufio.Writer 包在 io.Writer 外面。小段内容写入时，Write 返回成功只说明数据进入了缓冲写入器；缓冲区满了或显式调用 Flush 时，才会触发底层 *os.File.Write。因此不要只用“文件存在”或“文件大小为 0”判断成功，先把三个阶段拆开。

二、把 Flush 放在文件 Close 之前

下面的顺序适合先把问题讲清楚：显式写入、显式 Flush、显式 Close。代码里的每个错误都保留下来，便于知道空文件到底在哪一步产生。

package main

import (
    "bufio"
    "fmt"
    "os"
)

func writeReport(path string) error {
    // Create 会创建或截断目标文件，先确认打开阶段没有失败。
    f, err := os.Create(path)
    if err != nil {
        return fmt.Errorf("create file: %w", err)
    }

    // 发生后续错误时仍要释放文件句柄，但 Flush 必须在 Close 前完成。
    w := bufio.NewWriter(f)
    if _, err = w.WriteString("report: ready\n"); err != nil {
        _ = f.Close()
        return fmt.Errorf("write buffer: %w", err)
    }
    if err = w.Flush(); err != nil {
        _ = f.Close()
        return fmt.Errorf("flush file: %w", err)
    }
    // Flush 成功后，文件已经收到缓冲数据；Close 只负责结束句柄。
    if err = f.Close(); err != nil {
        return fmt.Errorf("close file: %w", err)
    }
    return nil
}

这里不建议把 Flush 写成孤零零的一行。官方文档明确要求写完后调用它；而 Flush 返回错误时，后续写入也不能再当作可靠成功。文件如果仍为空，先看这里的 flush file 错误，而不是立即增加缓冲区大小。

三、用 defer 逆序规则排查关闭顺序

defer 按后注册先执行。下面两句的执行顺序是 w.Flush() 再 f.Close()，因为文件关闭先注册、Flush 后注册：

f, err := os.Create("report.txt")
if err != nil {
    return err
}
defer f.Close() // 先注册，最后执行，作为兜底清理

w := bufio.NewWriter(f)
defer func() {
    // 后注册的 defer 先执行，所以先把缓冲数据送入文件。
    if flushErr := w.Flush(); flushErr != nil {
        fmt.Println("flush error:", flushErr)
    }
}()

不过，生产代码若需要把 Flush 错误返回给调用方，最好使用命名返回值并在 defer 中合并错误，或者直接采用上一节的显式顺序。不要在 f.Close() 之后再调用 w.Flush()：这时 Flush 可能返回“文件已关闭”，而且真正的错误还可能被忽略。

四、用最小检查清单复核空文件

1. 确认路径。打印 f.Name() 或记录绝对路径，避免查看了另一个同名文件。
2. 检查 Write。小于输入长度或返回错误时，不能继续假定数据有效。
3. 检查 Flush。它是缓冲写入的关键边界；发生错误后不要继续复用同一个 Writer。
4. 搜索后续的 Create。os.Create 会截断文件，第二次打开可能把刚写好的内容变成 0 字节。
5. 区分可见与持久。只要求读进程能看到内容时，Flush 通常足够；需要稳定存储语义时，再在 Flush 后调用 f.Sync()，并处理它的错误。

如果三个返回值都成功而文件仍为空，优先怀疑查看路径、后续截断或读取时机，而不是继续调整 bufio.NewWriterSize。缓冲区大小影响写入时机和性能，不会修复错误的生命周期顺序。

相关问题

只调用 f.Close()，为什么文件还是空的？

*os.File.Close 不会替代 bufio.Writer.Flush。缓冲数据仍在 Writer 中时，关闭底层文件会让后续 Flush 无法正常写入。

Flush 成功后还必须调用 Sync 吗？

不一定。普通程序只要让后续读取看到文件内容，通常检查 Flush 和 Close 即可；只有业务明确要求提交到稳定存储时，才把 Sync 纳入错误处理。

为什么 Write 没报错，Flush 却报错？

因为小数据可能只写进了 bufio 缓冲区，底层文件写入发生在 Flush 时。两处返回值都要检查。