Java中用synchronized实现线程安全文件追加，核心是用静态或路径映射锁对象确保同文件写入互斥，配合try-with-resources及时关闭流，避免锁粒度不当或锁对象失效；不可用this或File.class直接锁。
在 Java 中，用 synchronized 实现多线程安全的文件追加，核心是**确保多个线程对同一文件的写入操作互斥执行**。但要注意：synchronized 本身不能直接锁文件，只能锁对象（如类、实例、或显式锁对象），因此必须配合合理的同步粒度和 I/O 操作设计，避免锁范围过大影响性能，也防止因锁对象不一致导致失效。
用静态锁对象保护共享文件写入
适用于多个线程共用同一个文件路径（如日志文件），且希望所有线程串行追加内容：
- 定义一个 private static final Object 作为全局锁，所有写入方法都用它同步
- 每次追加前打开文件（推荐用
Files.newOutputStream(path, StandardOpenOption.APPEND)）、写入、立即关闭 —— 不要长期持有流 - 避免在 synchronized 块内做耗时操作（如网络请求、复杂计算），只包裹真正的 I/O 写入逻辑
示例：
（注意：实际项目中建议用 Log4j/SLF4J 等成熟日志框架）public class SafeFileAppender {
private static final Object WRITE_LOCK = new Object();
private static final Path LOG_PATH = Paths.get("app.log");
public static void appendLine(String line) throws IOException {
synchronized (WRITE_LOCK) {
try (OutputStream os = Files.newOutputStream(LOG_PATH, StandardOpenOption.CREATE, StandardOpenOption.APPEND);
PrintWriter pw = new PrintWriter(os, true)) {
pw.println(line);
}
}
}
}
用文件路径作为锁键，支持多文件并发写入
当多个线程可能向不同文件追加时，若统一用静态锁会严重串行化。更优做法是按文件路径哈希或缓存锁对象，实现“同文件互斥、不同文件并行”：
立即学习“Java免费学习笔记（深入）”；
- 使用 ConcurrentHashMap<String, Object> 缓存每个文件路径对应的锁对象
- 用
computeIfAbsent()安全创建锁，避免重复 new 导致锁失效 - 同步块仍只包裹流打开 + 写入 + 关闭，不包含路径解析等非关键逻辑
示例：
public class MultiFileAppender {
private static final ConcurrentHashMap<String, Object> LOCK_MAP = new ConcurrentHashMap<>();
public static void appendTo(String filePath, String content) throws IOException {
Path path = Paths.get(filePath);
Object lock = LOCK_MAP.computeIfAbsent(filePath, k -> new Object());
synchronized (lock) {
try (OutputStream os = Files.newOutputStream(path, StandardOpenOption.CREATE, StandardOpenOption.APPEND);
PrintWriter pw = new PrintWriter(os, true)) {
pw.println(content);
}
}
}
}
为什么不能直接 synchronized(this) 或 synchronized(File.class)？
常见误区及风险：
-
synchronized(this)：若每个线程持不同 Appender 实例，锁对象不同 → 同步失效 -
synchronized(File.class)：锁的是java.io.File类，不是你的业务文件，且可能与其他无关代码冲突 - 未关闭流或未捕获异常导致资源泄漏：务必用 try-with-resources，否则一次异常后流未关，后续写入可能失败
- 用
FileWriter构造时未设append=true：默认覆盖，不是追加
补充建议：比 synchronized 更稳的替代方案
单纯靠 synchronized 在高并发或分布式场景下有局限：
- 进程内有效，跨 JVM 进程无效（如多个 Java 应用写同一文件）→ 需
FileChannel.lock()获取文件系统级排他锁 - 大量小写入频繁加锁开销大 → 可考虑线程本地缓冲 + 批量落盘，或用
BlockingQueue + 单写线程模式 - 生产环境强烈建议用 Logback/Log4j2：内置异步追加、滚动策略、故障转移，且线程安全已深度优化
