应复用线程安全的单写入器并行输出控制台与文件,启用追加模式、强制行级刷新、主动检测错误,避免共用流或滥用缓存。

要让日志既在控制台实时显示,又在高并发下安全、不丢落地追加写入文件,关键不是“用缓存数据去配合输出流”,而是**避免滥用缓存、合理控制缓冲行为,并保障多线程写入安全**。所谓“高并发缓存数据”,如果理解为把日志先攒在内存队列里再批量刷盘,那反而会牺牲实时性;真正需要的是:低延迟落盘 + 线程安全 + 故障可感知。
启用追加模式并强制行级刷新
文件写入必须使用追加打开,且不能依赖默认缓冲策略:
- 用
new FileWriter("log.txt", true)或Files.newOutputStream(Paths.get("log.txt"), APPEND)确保每次写入都追加到末尾 - 绕过默认缓冲区:直接用
PrintWriter(out, true)(第二个参数开启自动 flush),或对BufferedWriter每次write() + newLine() + flush() - 禁用 stdout 缓冲(如 C++)可用
setvbuf(stdout, nullptr, _IONBF, 0);Java 中System.out通常已行缓冲,但不要依赖它同步文件
避免多线程竞争同一文件流
多个线程共用一个 PrintWriter 或 FileOutputStream 会导致内容错乱或丢失:
- 不推荐每个日志调用都新建流(
new PrintWriter(...)),会引发句柄争抢和 I/O 开销 - 应复用单个线程安全的写入器:例如用
java.util.concurrent.locks.ReentrantLock包裹printWriter.println()调用 - 更稳妥的做法是引入阻塞队列 + 单独日志线程:所有日志先
queue.offer(logLine),由后台线程顺序消费并刷盘
主动检测写入失败,不依赖静默成功
基础输出流(如 PrintWriter)在磁盘满、权限不足、文件被占用时不会抛异常,只会内部设错位:
- 每次写入后调用
printWriter.checkError(),返回true表示之前某次写入已失败 - 建议封装写入方法,失败时记录错误到备用路径(如内存日志或 stderr),并告警
- 若用
FileHandler(java.util.logging),需显式设setFlushAfterWrite(true)(Java 9+)
控制台与文件解耦,各自独立管理
控制台输出和文件写入本质是两个不同目标,不应强耦合:
- 不要试图用
freopen或dup2把stdout同时引向控制台和文件——这做不到双路输出 - 正确做法是:控制台走
System.out.println(),文件走独立PrintWriter,两者并行调用互不影响 - 如需统一格式,可抽取公共日志方法:
log(Level.INFO, "msg")内部同时触发控制台打印和文件写入











