理解Logback的默认行为与日志累加性
在使用logback进行日志记录时，开发者可能会遇到一个常见场景：即使没有显式配置consoleappender，日志信息仍然会出现在控制台上。同时，如果程序中配置了文件appender，日志会同时输出到文件和控制台。这种行为的根源在于logback的默认配置策略以及其核心概念——日志累加性（additivity）。
- 默认配置： 当Logback在classpath中找不到logback.xml或logback-test.xml配置文件时，它会回退到默认配置。这个默认配置通常会包括一个绑定到System.err的ConsoleAppender。这意味着，即使你没有手动配置，Logback也可能已经为你添加了一个控制台输出器。
- 日志累加性（Additivity）： Logback中的Logger是分层的，形成一个树状结构。每个Logger都有一个名为additivity的布尔属性，其默认值为true。当一个Logger的additivity为true时，它不仅会将其日志事件发送到自己直接附加的Appender，还会将这些事件传递给其父Logger。父Logger收到事件后，也会将其发送到自己附加的Appender，并继续向上级父Logger传递，直到达到根Logger。根Logger是所有Logger的祖先，它没有父Logger，其additivity属性通常不影响事件的进一步传播，但它会处理所有到达它的事件。
因此，即使你为某个特定的Logger添加了RollingFileAppender，如果该Logger或其任何祖先Logger（包括根Logger）的additivity为true，并且其祖先Logger附加了ConsoleAppender（无论是默认的还是显式配置的），那么日志事件最终都会被ConsoleAppender处理，导致日志输出到控制台。
问题场景示例
考虑以下Java代码片段，它尝试通过编程方式配置一个RollingFileAppender来记录日志，但并未涉及ConsoleAppender：
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.util.FileSize;
import org.slf4j.LoggerFactory;
public class LoggingSetup {
private String logFilePath = "logs/application.log";
private Level logLevel = Level.INFO;
public void initializeLogging(final String logName) {
LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();
final Logger log = lc.getLogger(logName);
log.setLevel(this.logLevel);
// 设置文件日志
setupFileLogging(log, lc);
// 记录一些日志
log.info("This is an INFO message.");
log.warn("This is a WARN message.");
log.error("This is an ERROR message.");
}
private void setupFileLogging(final Logger log, final LoggerContext loggerContext) {
// 创建并配置 RollingFileAppender
RollingFileAppender rollingFileAppender = new RollingFileAppender<>();
rollingFileAppender.setContext(loggerContext);
rollingFileAppender.setFile(this.logFilePath);
rollingFileAppender.setName("FILE-" + log.getName());
// 配置滚动策略
SizeAndTimeBasedRollingPolicy rollingPolicy = new SizeAndTimeBasedRollingPolicy<>();
rollingPolicy.setContext(loggerContext);
rollingPolicy.setParent(rollingFileAppender);
rollingPolicy.setFileNamePattern("logs/application-%d{yyyy-MM-dd}.%i.log.gz");
rollingPolicy.setMaxFileSize(FileSize.valueOf("10MB"));
rollingPolicy.setMaxHistory(7); // 保留7天历史日志
rollingPolicy.start();
rollingFileAppender.setRollingPolicy(rollingPolicy);
// 配置编码器
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);
rollingFileAppender.start();
// 将Appender添加到Logger
log.addAppender(rollingFileAppender);
}
public static void main(String[] args) {
new LoggingSetup().initializeLogging("com.example.myapp");
}
} 运行上述代码后，你会发现日志不仅被写入了logs/application.log文件，还同时输出到了控制台。这是因为com.example.myapp这个Logger的additivity属性默认为true，它会将日志事件传递给其父Logger，直到根Logger。如果根Logger（或其祖先）默认附加了ConsoleAppender，那么这些事件就会被控制台处理。
解决方案：控制日志累加性
要解决这个问题，即只将日志输出到文件而不输出到控制台，我们需要显式地禁用特定Logger的日志累加性。这可以通过调用Logger实例的setAdditive(false)方法来实现。
当logger.setAdditive(false)被设置后，该Logger将不再将其日志事件传递给其父Logger。它只会将其日志事件发送到直接附加给它的Appender。
修正后的代码示例
在上述initializeLogging方法中添加一行代码即可解决问题：
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.util.FileSize;
import org.slf4j.LoggerFactory;
public class LoggingSetupCorrected {
private String logFilePath = "logs/application.log";
private Level logLevel = Level.INFO;
public void initializeLogging(final String logName) {
LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();
final Logger log = lc.getLogger(logName);
log.setLevel(this.logLevel);
// 关键一步：禁用日志累加性，防止日志事件传递给父Logger
log.setAdditive(false);
// 设置文件日志
setupFileLogging(log, lc);
// 记录一些日志
log.info("This is an INFO message.");
log.warn("This is a WARN message.");
log.error("This is an ERROR message.");
}
private void setupFileLogging(final Logger log, final LoggerContext loggerContext) {
// 创建并配置 RollingFileAppender
RollingFileAppender rollingFileAppender = new RollingFileAppender<>();
rollingFileAppender.setContext(loggerContext);
rollingFileAppender.setFile(this.logFilePath);
rollingFileAppender.setName("FILE-" + log.getName());
// 配置滚动策略
SizeAndTimeBasedRollingPolicy rollingPolicy = new SizeAndTimeBasedRollingPolicy<>();
rollingPolicy.setContext(loggerContext);
rollingPolicy.setParent(rollingFileAppender);
rollingPolicy.setFileNamePattern("logs/application-%d{yyyy-MM-dd}.%i.log.gz");
rollingPolicy.setMaxFileSize(FileSize.valueOf("10MB"));
rollingPolicy.setMaxHistory(7); // 保留7天历史日志
rollingPolicy.start();
rollingFileAppender.setRollingPolicy(rollingPolicy);
// 配置编码器
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);
rollingFileAppender.start();
// 将Appender添加到Logger
log.addAppender(rollingFileAppender);
}
public static void main(String[] args) {
new LoggingSetupCorrected().initializeLogging("com.example.myapp");
}
} 通过添加log.setAdditive(false);这行代码，再次运行程序，你会发现日志将只被写入到logs/application.log文件，而控制台将不再有任何输出。
注意事项与最佳实践
-
配置文件优先： 对于大多数生产环境应用，强烈建议使用logback.xml或logback-test.xml进行日志配置。配置文件提供了更清晰、更易于维护的方式来管理Appender、Logger级别和累加性等设置。在配置文件中，可以通过
来设置累加性。 - 根Logger的累加性： 根Logger（Root Logger）没有父Logger，因此其additivity属性通常不影响事件向上级传递，但它会处理所有到达它的事件。如果你想完全禁用所有Logger的控制台输出，并且不使用配置文件，你可能需要确保根Logger没有附加ConsoleAppender，或者为所有相关Logger设置additivity="false"。
- Logger层次结构： 理解Logger的命名和层次结构对于有效管理日志至关重要。例如，com.example.myapp是com.example的子Logger，com.example又是com的子Logger，最终都继承自根Logger。
- 动态配置： 编程方式配置Logback适用于需要根据运行时条件动态调整日志行为的场景，例如在测试环境中启用详细日志，或根据用户设置改变日志输出目标。
总结
Logback的日志累加性（additivity）是一个强大但有时容易被忽视的特性。它允许日志事件在Logger层次结构中传播，从而实现灵活的日志处理。然而，当开发者希望精确控制日志输出，例如仅将日志写入文件而不输出到控制台时，理解并正确使用logger.setAdditive(false)就变得至关重要。通过禁用特定Logger的累加性，我们可以有效地阻止日志事件向父Logger传播，从而避免不必要的控制台输出，实现更精细的日志管理。
