调用 BufferedWriter.write 之后打开目标文件，文件大小是 0 字节，这类情况在 Java I/O 调试中并不少见。表面上看内容已经写入了对象，实际上文件系统还没有收到任何数据。要理解这个差异，必须先从 BufferedWriter 的缓冲机制说起。
BufferedWriter 的缓冲机制决定了 flush 的重要性
BufferedWriter 属于 Java I/O 中的装饰器类。它不直接和文件打交道，而是包装一个 Writer 实例（例如 FileWriter 或 OutputStreamWriter），在内存中增加缓冲层。其内部默认使用一个长度为 8192 个字符的 char 数组。调用 write(String s) 时，字符并不会立即发送给底层输出流，而是先复制到该数组；只有当数组剩余空间不足以容纳下一次写入、或者程序主动调用 flush()、close() 时，缓冲区内容才会被批量写出。这种设计可以减少系统调用次数，在大量小数据写入时显著提升性能，但也让写入行为变得不那么直观。
因此，如果只调用 write 后马上查看文件，文件很可能仍然是 0 字节。下面这段代码就是一个典型场景：
BufferedWriter writer = new BufferedWriter(new FileWriter("out.txt"));
writer.write("hello");
// 此时打开 out.txt，常常是空文件
这段代码没有调用 close 也没有调用 flush，不能依赖 JVM 在进程结束时自动刷新，因为 Java 规范并没有保证未关闭的 BufferedWriter 会执行刷盘操作。最终这些字符留在了用户态缓冲区，随着进程结束直接丢失。要验证这一点，可以在写入后加入 writer.flush()，再查看文件内容，就会看到 hello。
另外，close() 内部通常会调用 flush()，但这依赖于具体实现。BufferedWriter 的 close() 会先刷新缓冲区再关闭底层流。也就是说，关闭流是确保数据落盘的最常用方式。反过来，只调用 flush() 而不关闭流，数据虽然写出，但底层文件描述符仍然被占用，可能造成资源泄漏。理解这两者关系后，排查空文件就有了明确方向。
几种典型空文件场景与错误写法
第一种是忘记关闭流。简单测试程序经常在 main 里创建 writer、写入内容然后直接结束。由于没有调用 close，缓冲区数据不会刷出。有人误以为 JVM 退出时会像 C 标准库那样自动清理，实际 Java 并不保证对未关闭的 Writer 执行 flush。不同 JVM 或不同版本偶尔能写出，也容易造成间歇性问题。
public static void main(String[] args) throws IOException {
BufferedWriter writer = new BufferedWriter(new FileWriter("data.txt"));
writer.write("important data");
// 这里缺少 writer.close()
}
第二种更隐蔽，是异常路径吞掉了关闭操作。看下面这个结构：
BufferedWriter writer = null;
try {
writer = new BufferedWriter(new FileWriter("data.txt"));
writer.write("important data");
// 如果这里抛出异常，下面的 close 不会执行
writer.close();
} catch (IOException e) {
e.printStackTrace();
}
如果 write 或者中途业务逻辑抛出异常，流程直接跳到 catch，close 没有执行。即使外层 catch 捕获了异常，文件也可能为空或只有缓存中没刷出的部分。这类问题在生产环境非常典型，因为异常路径往往不是正常流程测试的重点。
第三种是写入的字符串本身为空。例如从请求参数、集合拼接或配置文件读取来的内容为空字符串，调用 write("") 后文件自然是空的。这种问题并非缓冲机制引起，但常常和写入后空文件混在一起。排查时可以在 write 之前打印字符串长度，确认数据源是否真的产出了内容。还要注意不要把 null 传给 write，否则会抛出 NullPointerException，而不是安静地产生空文件。
第四种是检查了错误的文件路径。使用相对路径时，工作目录可能不是项目根目录，而是运行环境的当前目录。开发者在 IDE 中查看的是项目下的 out.txt，但程序实际把文件写到了 bin、target 或用户目录。此时文件并不是空，而是看错了位置。可以打印 new File("out.txt").getAbsolutePath() 来核对真实路径。
让数据真正落盘的最小修复方案
推荐优先使用 try-with-resources。这是 Java 7 开始提供的语法，可以自动在 try 块结束时调用 close，close 又会触发 flush，不需要手动关闭流。
try (BufferedWriter writer = new BufferedWriter(new FileWriter("output.txt"))) {
writer.write("hello");
writer.newLine();
writer.write("world");
} catch (IOException e) {
e.printStackTrace();
}
如果业务需要中途强制落盘，可以显式调用 flush() 后继续写入。例如写入大文件时定期 flush，避免缓冲区积压过多导致内存占用，或者在日志场景中希望及时看到内容。但注意频繁 flush 会降低性能，因为它会触发底层系统调用和磁盘写入。一般在每个逻辑块结束、或需要其他进程读取文件时调用一次即可。
对于传统写法，必须把 close 放进 finally 中。下面是一种可行但较为啰嗦的方式：
BufferedWriter writer = null;
try {
writer = new BufferedWriter(new FileWriter("data.txt"));
writer.write("important data");
} catch (IOException e) {
e.printStackTrace();
} finally {
if (writer != null) {
try {
writer.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
这种写法能保证 close 执行，但 finally 中关闭流时如果抛出新异常，可能会覆盖 try 中的原始异常，造成排查困难。try-with-resources 会将 close 异常标记为 suppressed，原始异常不会被吞掉，因此更推荐。
此外，使用 Files.newBufferedWriter 可以直接返回带缓冲的 writer，并且明确指定字符集，避免 FileWriter 依赖平台默认编码导致内容不可预期。
Path target = Paths.get("output.txt");
try (BufferedWriter writer = Files.newBufferedWriter(target, StandardCharsets.UTF_8)) {
writer.write("hello");
}
空文件诊断清单与可靠写入实践
遇到 BufferedWriter 写入后文件为空，可以按以下顺序逐个排查：
- 确认写入内容非空：在 write 之前打印字符串长度或内容，排除数据源本身为空的情况。
- 确认 close 或 flush 调用：检查正常返回、异常跳出和提前 return 等所有代码路径。
- 确认文件路径：打印绝对路径，核对实际查看的文件是否就是写入的文件。
- 确认写入模式：
new FileWriter(file, false)会覆盖旧文件，但只有关闭后才可见；append 参数为 true 时若原文件为空，结果仍可能为空。 - 确认字符编码：读取端使用错误编码可能显示为空或乱码，但文件大小不一定为零。
- 确认多线程写入：多个线程共享同一个 BufferedWriter 时，字符交错或缓冲刷新顺序异常可能导致数据丢失，需要同步或每个线程独立 writer。
- 最小化重现：只保留一个 main 方法，写入固定字符串、关闭、检查文件，逐步加回业务逻辑。
下面是一个完整的最小可运行示例：
import java.io.BufferedWriter;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class BufferedWriterDemo {
public static void main(String[] args) {
Path target = Paths.get("check.txt");
try (BufferedWriter writer = Files.newBufferedWriter(target, StandardCharsets.UTF_8)) {
writer.write("hello from buffered writer");
// 如果需要让其他进程立即读取，可以手动 flush
writer.flush();
System.out.println("写入完成，路径：" + target.toAbsolutePath());
} catch (IOException e) {
e.printStackTrace();
}
}
}
空文件问题大多不是磁盘故障，而是缓冲区和资源管理导致的。只要坚持用 try-with-resources、必要时显式 flush、核对绝对路径和写入内容，绝大多数问题都能消除。如果仍然为空，再检查文件系统权限、磁盘剩余空间或底层流是否被提前关闭。
Java BufferedWriter空文件flush修改时间：2026-09-21 00:28:47