Java中“双重刷盘”指先调用OutputStreamWriter.flush()清空字符缓冲区，再调用FileOutputStream.getFD().sync()强制内核缓冲区落盘；二者缺一不可，且sync()需手动显式调用。

Java 中并没有标准库提供的 FlushedOutputStream 类，它不是 JDK 内置类，也不是 Apache Commons 或 Guava 等主流库中的公开类。因此，“结合 OutputStreamWriter 和 FlushedOutputStream 实现强制双重刷盘”这一说法存在概念混淆——**你无法直接“结合”一个不存在的标准类型**。

什么是真正的“双重刷盘”需求？

实际开发中，所谓“双重刷盘”，通常是指： - 第一层：将 Java 字符缓冲区（OutputStreamWriter 内部的 CharBuffer）内容写入底层字节流（如 FileOutputStream）→ 调用 writer.flush()； - 第二层：确保这些字节真正落盘（而非仅停留在操作系统页缓存）→ 调用 out.getFD().sync()（即 FileDescriptor.sync()）。

正确实现强制落盘的步骤

要达成可靠刷盘效果，需手动组合以下三步（缺一不可）：

• 使用 OutputStreamWriter 包装带缓冲的 FileOutputStream（避免每次 write 都触发系统调用）
• 显式调用 writer.flush()，把字符转字节并写入 FileOutputStream 的缓冲区
• 再调用 fileOutputStream.getFD().sync()，强制 OS 将该文件描述符关联的内核缓冲区同步到磁盘

示例代码：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

FileOutputStream fos = new FileOutputStream("data.txt");
OutputStreamWriter writer = new OutputStreamWriter(fos, StandardCharsets.UTF_8);
<p>try {
writer.write("Hello, world!");
writer.flush(); // ← 刷字符缓冲 → 字节缓冲
fos.getFD().sync(); // ← 刷内核缓冲 → 物理磁盘
} finally {
writer.close(); // close() 内部会 flush，但 sync 仍需手动调
}</p>

为什么不能依赖自动 flush 或 close？

OutputStreamWriter.close() 会调用 flush()，但不会调用 sync()；FileOutputStream.close() 也不保证落盘（JDK 文档明确说明 sync 需显式调用）。某些场景（如金融交易日志、数据库 WAL）要求数据必须物理写入磁盘才认为“已提交”，此时 sync() 是关键保障。

注意平台与性能影响

FileDescriptor.sync() 是阻塞系统调用，性能开销大，频繁调用会显著降低吞吐。生产中应权衡可靠性与性能： - 日志类场景可每条记录后 sync()（强一致性） - 批处理场景建议批量写 + 定期 sync()（如每 100 条或 1 秒一次） - Linux 下还可考虑 O_DSYNC（通过 FileChannel.open(..., StandardOpenOption.SYNC)），由内核自动同步元数据+数据，语义更严谨

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南