flush()是确保数据及时可见的关键操作，用于清空缓冲区并提交至下层；必须在关键日志、HTTP流响应、Socket协议包发送及多线程共享写入后手动调用，且仅对带缓冲流有效。

Java 中的 flush() 方法不是“可有可无”的装饰，而是控制数据可见性与安全性的关键操作。它不关闭流，只把缓冲区里还没送出去的数据，一次性推给下一层——可能是文件系统、网络栈，也可能是另一个过滤流。用对了，能避免日志丢失、响应卡顿、状态不同步；用错了，比如盲目高频调用或误以为它等于落盘，则可能白忙活。

什么时候必须手动调用 flush()

以下场景不能依赖自动 flush 或 close 隐式触发：

• 写完一条关键日志后需立即可见（如错误告警、审计记录），防止 JVM 崩溃导致缓冲区数据丢失
• HTTP 响应中已写入响应头和部分正文，但希望客户端浏览器/工具能立刻开始接收和渲染（例如服务端推送流）
• 向 Socket 输出流写完一个完整协议包（如自定义二进制消息），需确保对方 TCP 接收缓冲区能及时收到整包，避免粘包或延迟
• 多线程协作时，一个线程写入共享文件后调用 flush()，虽不能替代同步机制，但能减少另一线程读取旧内容的概率

怎么调用才真正起作用

flush() 只在带缓冲的流中有效。底层无缓冲的流（如直接使用 FileOutputStream）其 flush() 是空实现；ByteArrayOutputStream 的 flush() 也不执行 I/O。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

• 典型有效组合：用 BufferedOutputStream 包装 FileOutputStream，或用 BufferedWriter 包装 FileWriter 或 OutputStreamWriter
• 链式包装时，调一次最外层的 flush() 会逐层向下触发，例如 PrintWriter → BufferedWriter → OutputStreamWriter → FileOutputStream，全部清空
• 示例代码：

  FileOutputStream fos = new FileOutputStream("log.bin");
  BufferedOutputStream bos = new BufferedOutputStream(fos, 8192);
  bos.write("START".getBytes());
  bos.flush(); // ✅ 此刻 "START" 已进入操作系统 write() 缓冲区
  

flush 不等于数据落盘，别混淆层级

Java 的 flush() 最多只做到“交给操作系统”，不保证写入磁盘：

立即学习“Java免费学习笔记（深入）”；

• 它把 Java 用户态缓冲区数据交给 FileOutputStream，后者调用系统 write() 系统调用
• 而 write() 默认只将数据送入内核页缓存（page cache），由 OS 在后台异步刷盘
• 如需强持久化（例如金融交易凭证），必须额外调用：
    – fos.getFD().sync()（适用于 JDK 所有版本）
    – 或 fileChannel.force(true)（NIO 方式）

常见误区与建议

避开这几个典型坑：

• 不要在每次 write() 后都 flush()：严重削弱缓冲价值，I/O 性能骤降
• 不要以为 close() 能代替中间 flush()：虽然 close() 会自动 flush，但若程序在写完关键数据后、close 前崩溃，这部分数据就丢了
• 网络流中调用 flush() 并不保证对方已收到：它只确保数据进了本机 TCP 发送缓冲区，仍可能滞留在网卡、路由器或对方接收缓冲区
• 优先用 try-with-resources 管理资源，它会在异常或正常退出时自动 close → 自动 flush，但关键节点仍建议显式 flush 加保险