Logback的默认行为与Appender累加性
在使用logback作为日志框架时，开发者有时会遇到一个看似矛盾的现象：即使没有在配置中显式声明consoleappender，日志消息仍然会输出到控制台。与此同时，如果程序中通过代码动态添加了其他appender（例如rollingfileappender），日志也会同时写入文件。这种双重输出的根源在于logback的两个核心机制：默认配置和appender的累加性（additivity）。
- 默认配置： 当Logback在classpath中找不到任何名为logback.xml或logback-test.xml的配置文件时，它会退回到其默认配置。这个默认配置非常简单，它会自动创建一个关联到根Logger的ConsoleAppender。这意味着，即使你没有编写任何Logback配置，你的日志消息也会默认打印到标准输出。
- Appender累加性（Additivity）： 这是理解此问题的关键。Logback（以及Log4j等日志框架）中的Logger是分层的，形成一个树状结构。当一个日志事件（例如log.info("message")）被某个Logger处理时，该事件不仅会由当前Logger自身关联的所有Appender进行处理，还会根据additivity属性的设置，向上层Logger（即父Logger）传递。这个过程会一直持续到根Logger。每个被传递到的Logger，都会再次由其关联的所有Appender处理该日志事件。additivity属性的默认值是true。
因此，当你的代码动态创建了一个Logger并为其添加了一个RollingFileAppender时，由于additivity默认为true，该Logger处理的日志事件会向上冒泡，最终到达根Logger。而根Logger在默认情况下（或通过其他配置）通常关联着一个ConsoleAppender，从而导致日志消息在控制台和文件中同时出现。
解决方案：禁用Logger的Additivity特性
要解决这个问题，即只将日志输出到自定义的Appender（如文件），而阻止其传递到父Logger（包括默认的根Logger及其ConsoleAppender），我们需要显式地禁用Logger的additivity特性。这可以通过调用Logger实例的setAdditive(false)方法来实现。
当logger.setAdditive(false)被设置后，该Logger处理的任何日志事件将不会再向上层Logger传递。这意味着日志事件将只由当前Logger所关联的Appender进行处理，从而有效地切断了与默认ConsoleAppender的联系。
编程实践示例
以下是一个完整的Java代码示例，演示了如何通过编程方式配置Logback，并禁用additivity以确保日志只输出到文件而不输出到控制台：
import ch.qos.logback.classic.Level;
import ch.qos.logback.classic.Logger;
import ch.qos.logback.classic.LoggerContext;
import ch.qos.logback.classic.encoder.PatternLayoutEncoder;
import ch.qos.logback.core.rolling.RollingFileAppender;
import ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy;
import ch.qos.logback.core.spi.ContextAwareBase;
import ch.qos.logback.core.util.FileSize;
import org.slf4j.LoggerFactory;
public class LogbackFileOnlyConfigurator {
private String logFilePath = "logs/application.log";
private Level logLevel = Level.INFO;
private LoggerContext loggerContext = (LoggerContext) LoggerFactory.getILoggerFactory();
/**
* 初始化并配置指定名称的Logger。
*
* @param logName 要配置的Logger名称。
*/
public void initializeLogging(final String logName) {
// 获取Logger实例
final Logger logger = loggerContext.getLogger(logName);
logger.setLevel(this.logLevel);
// 核心步骤：禁用Logger的additivity特性
// 这将阻止日志事件传递给父Logger，从而避免默认的控制台输出
logger.setAdditive(false);
// 设置文件日志Appender
setupFileLogging(logger);
// 示例日志输出
logger.info("This is an INFO message, should only go to file.");
logger.debug("This is a DEBUG message (if level permits), should only go to file.");
logger.warn("A warning message, also to file only.");
}
/**
* 配置一个滚动文件Appender。
*
* @param logger 目标Logger。
*/
private void setupFileLogging(final Logger logger) {
// 创建RollingFileAppender
RollingFileAppender rollingFileAppender = new RollingFileAppender<>();
rollingFileAppender.setContext(loggerContext); // 必须设置context
rollingFileAppender.setName("FILE-" + logger.getName()); // 为Appender命名
rollingFileAppender.setFile(this.logFilePath);
// 设置日志编码器
PatternLayoutEncoder encoder = new PatternLayoutEncoder();
encoder.setContext(loggerContext);
encoder.setPattern("%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n");
encoder.start(); // 启动编码器
rollingFileAppender.setEncoder(encoder);
// 设置滚动策略
SizeAndTimeBasedRollingPolicy rollingPolicy = new SizeAndTimeBasedRollingPolicy<>();
rollingPolicy.setContext(loggerContext);
rollingPolicy.setParent(rollingFileAppender); // 关联到Appender
rollingPolicy.setFileNamePattern("logs/archive/application-%d{yyyy-MM-dd}.%i.log.gz"); // 归档文件名模式
rollingPolicy.setMaxFileSize(FileSize.valueOf("10MB")); // 单个文件最大10MB
rollingPolicy.setMaxHistory(30); // 保留30天历史文件
rollingPolicy.setTotalSizeCap(FileSize.valueOf("1GB")); // 所有归档文件总大小限制
rollingPolicy.start(); // 启动滚动策略
rollingFileAppender.setRollingPolicy(rollingPolicy);
rollingFileAppender.start(); // 启动Appender
// 将Appender添加到Logger
logger.addAppender(rollingFileAppender);
}
public static void main(String[] args) {
LogbackFileOnlyConfigurator configurator = new LogbackFileOnlyConfigurator();
// 初始化一个名为"com.example.MyApp"的Logger
configurator.initializeLogging("com.example.MyApp");
// 如果需要，也可以配置其他Logger，它们同样不会输出到控制台
Logger anotherLogger = configurator.loggerContext.getLogger("com.example.AnotherModule");
anotherLogger.setLevel(Level.DEBUG);
anotherLogger.setAdditive(false); // 同样禁用additivity
// 为anotherLogger添加一个单独的Appender，或者复用上面的文件Appender
// anotherLogger.addAppender(configurator.getFileAppenderForLogger(anotherLogger)); // 假设有一个方法可以获取或创建Appender
anotherLogger.info("This is a message from another module, also file only.");
anotherLogger.debug("This is a debug message from another module.");
// 关闭LoggerContext以确保所有Appender正确关闭
((LoggerContext) LoggerFactory.getILoggerFactory()).stop();
}
} 代码说明：
- loggerContext.getLogger(logName)：获取或创建指定名称的Logger。
- logger.setLevel(this.logLevel)：设置Logger的日志级别。
- logger.setAdditive(false)：这是解决问题的关键。它指示Logback，该Logger的日志事件不应传递给其父Logger。
- RollingFileAppender的配置：展示了如何设置文件路径、编码器和滚动策略，以实现日志的按文件大小和时间滚动归档。
- appender.setContext(loggerContext)和encoder.setContext(loggerContext)：在编程配置Appender和Encoder时，务必设置它们的Context，通常是LoggerContext实例。
- appender.start()和encoder.start()：在Appender和Encoder配置完成后，需要调用start()方法来初始化和激活它们。
注意事项
- 配置优先级： 如果你的项目中同时存在logback.xml或logback-test.xml配置文件，那么这些文件的配置将优先于编程方式的默认配置。在这种情况下，你需要确保配置文件中没有为你的Logger或其父Logger设置additivity="true"（或不设置，因为默认就是true），或者显式地设置为additivity="false"。
- 根Logger： 即使你为某个特定的Logger设置了additivity=false，这只影响该Logger及其子Logger的事件传递行为。根Logger（root logger）通常是Logger层次结构的顶端，它默认拥有ConsoleAppender。如果你希望完全禁用所有日志的控制台输出，并且不使用配置文件，你可能需要更精细地控制根Logger。但在多数情况下，为应用程序特定的Logger设置additivity=false已足够。
- 层次结构理解： 深入理解Logback的Logger层次结构和Appender的工作原理，是解决这类问题的基础。Logger的名称通常是点分隔的（如com.example.MyApp），这决定了它们的父子关系。
总结
Logback在未显式配置ConsoleAppender时仍输出日志到控制台，是由于其默认配置和Logger的additivity特性共同作用的结果。通过在编程中为特定的Logger调用setAdditive(false)方法，可以有效地阻止日志事件向上传递到父Logger（包括根Logger），从而避免不必要的控制台输出，实现对日志流向的精确控制。理解并恰当利用additivity特性，是Logback高级配置和故障排查的关键。
