Java多线程日志问题：如何避免重复创建日志文件

首先得搞明白为啥会出现log.txt和log.txt.1：这是因为多线程环境下，日志器的FileHandler被重复初始化了——当多个线程同时尝试创建并绑定同一个日志文件的FileHandler时，第二个线程会发现文件已被占用（或判定需要滚动），于是自动生成带后缀的新文件。要解决这个问题，核心是保证日志器和FileHandler的全局唯一性，且初始化过程线程安全。

1. 实现线程安全的单例日志工具类 #

绝对不能让每个线程都去初始化日志器和FileHandler，而是要提前全局初始化好，或者用双重检查锁保证只初始化一次。这里给你一个实用的单例日志工具类示例：

import java.io.IOException;
import java.util.logging.FileHandler;
import java.util.logging.Level;
import java.util.logging.Logger;
import java.util.logging.SimpleFormatter;

public class GlobalLogUtil {
    // 全局唯一的日志器实例，volatile保证多线程可见性
    private static volatile Logger logger;

    // 私有构造，禁止外部实例化
    private GlobalLogUtil() {}

    public static Logger getLogger() {
        if (logger == null) {
            // 双重检查锁，确保线程安全的单例初始化
            synchronized (GlobalLogUtil.class) {
                if (logger == null) {
                    logger = Logger.getLogger("GlobalAppLogger");
                    try {
                        // 关键：append设为true，日志追加到文件末尾而非触发滚动
                        FileHandler fileHandler = new FileHandler("log.txt", true);
                        // 设置可读的文本格式输出
                        fileHandler.setFormatter(new SimpleFormatter());
                        // 移除默认控制台处理器，避免重复输出
                        for (var handler : logger.getHandlers()) {
                            logger.removeHandler(handler);
                        }
                        logger.addHandler(fileHandler);
                        logger.setLevel(Level.ALL);
                    } catch (IOException e) {
                        logger.log(Level.SEVERE, "初始化文件日志处理器失败", e);
                    }
                }
            }
        }
        return logger;
    }
}

所有线程都通过GlobalLogUtil.getLogger()获取同一个日志器实例，确保只有一个FileHandler绑定到log.txt，从根源避免重复创建导致的多文件问题。

2. 必须设置FileHandler的append参数为true #

创建FileHandler时，一定要把第二个参数设为true——这个参数控制日志是追加到文件末尾，还是覆盖/触发滚动。如果省略这个参数，默认是false，此时文件存在时会自动生成log.txt.1这类滚动文件。

错误写法（默认触发滚动）：

// 无append参数，默认false，文件存在时生成log.txt.1
FileHandler fileHandler = new FileHandler("log.txt");

正确写法（追加模式）：

// append设为true，日志直接追加到原文件
FileHandler fileHandler = new FileHandler("log.txt", true);

3. 避免重复添加FileHandler #

如果代码中存在多个地方给同一个Logger添加FileHandler，哪怕是同一线程多次执行，也会导致多个Handler同时写入，可能触发文件异常。所以初始化时要先检查Logger是否已有对应的Handler：

// 检查是否已绑定FileHandler，避免重复添加
boolean hasFileHandler = false;
for (var handler : logger.getHandlers()) {
    if (handler instanceof FileHandler) {
        hasFileHandler = true;
        break;
    }
}
if (!hasFileHandler) {
    FileHandler fileHandler = new FileHandler("log.txt", true);
    fileHandler.setFormatter(new SimpleFormatter());
    logger.addHandler(fileHandler);
}

4. 可选：用全局配置文件统一管理（Java 9+） #

如果是Java 9及以上版本，可以通过logging.properties全局配置日志，避免代码中手动初始化的线程安全问题。在配置文件中添加：

handlers=java.util.logging.FileHandler
java.util.logging.FileHandler.pattern=log.txt
java.util.logging.FileHandler.append=true
java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter

启动程序时指定配置文件：

java -Djava.util.logging.config.file=./logging.properties YourMainClass

内容的提问来源于stack exchange，提问作者willh99