如何移除Java自定义Log Handler产生的重复日志与默认格式内容？

嘿，这个问题我之前也踩过坑！日志重复输出通常是因为默认的ConsoleHandler还在生效，和你手动注册的自定义Handler同时输出日志了。下面给你几个靠谱的解决办法：

1. 先移除根Logger的默认ConsoleHandler #

Java的java.util.logging框架里，根Logger（Logger.getLogger("")）默认自带一个ConsoleHandler，如果你直接往里面加自己的Handler，就会两个Handler同时输出日志。解决办法是先把默认的删掉：

import java.util.logging.ConsoleHandler;
import java.util.logging.Handler;
import java.util.logging.Level;
import java.util.logging.Logger;

public class LogSetup {
    public static void initCustomLogging() {
        // 获取根Logger
        Logger rootLogger = Logger.getLogger("");
        
        // 遍历并移除所有默认的ConsoleHandler
        for (Handler handler : rootLogger.getHandlers()) {
            if (handler instanceof ConsoleHandler) {
                rootLogger.removeHandler(handler);
            }
        }
        
        // 初始化你的自定义Handler和格式化器
        ConsoleHandler customConsoleHandler = new ConsoleHandler();
        customConsoleHandler.setFormatter(new ProxyLogFormat());
        
        // 添加自定义Handler到根Logger
        rootLogger.addHandler(customConsoleHandler);
        
        // 记得设置日志级别（按需调整）
        rootLogger.setLevel(Level.INFO);
        customConsoleHandler.setLevel(Level.INFO);
    }
}

调用这个初始化方法后，就只会输出你自定义格式的日志了。

2. 检查日志配置文件（如果用了的话） #

如果你是通过logging.properties配置日志的，要确保里面没有重复配置ConsoleHandler。默认的配置文件里通常会有这样一行：

handlers= java.util.logging.ConsoleHandler

你可以注释掉这行，然后替换成你的自定义配置：

# 注释掉默认的handler
# handlers= java.util.logging.ConsoleHandler
# 配置自定义handler
handlers= com.yourpackage.YourCustomConsoleHandler
# 指定格式化器
com.yourpackage.YourCustomConsoleHandler.formatter= com.yourpackage.ProxyLogFormat

注意：尽量不要同时用代码和配置文件两种方式配置日志，容易出现冲突。

3. 禁用Logger的父Handler继承 #

如果你是给某个具体的子Logger（比如Logger.getLogger(YourService.class.getName())）添加的Handler，那默认情况下子Logger的日志会传递给父Logger（包括根Logger）的Handler，导致重复输出。这时候可以关掉继承：

Logger serviceLogger = Logger.getLogger(YourService.class.getName());
// 禁用父Logger的Handler，只使用当前Logger的自定义Handler
serviceLogger.setUseParentHandlers(false);

ConsoleHandler customHandler = new ConsoleHandler();
customHandler.setFormatter(new ProxyLogFormat());
serviceLogger.addHandler(customHandler);

最后小提醒 #

如果还是有重复，记得检查一下是不是多个地方都注册了Handler，或者日志级别设置导致的（比如根Logger级别是ALL，而你的自定义Handler级别是INFO，可能会有额外输出）。

内容的提问来源于stack exchange，提问作者Matthew L Parks