进阶之路：Java 日志框架全画传（下）
凌云时刻 · 技术
导读：随着互联网和大数据的蓬勃发展，分布式日志系统以及日志分析系统得到了广泛地应用。目前，几乎在所有应用程序中，都会用到各种各样的日志框架来记录程序的运行信息。鉴于此，工程师十分有必要熟悉主流的日志记录框架。
作者 | 书澜
来源 | 凌云时刻（微信号：linuxpk）
前言
本篇为《进阶之路：Java 日志框架全画传》系列下篇，将结合具体案例介绍日志使用示例及常见报错。
上篇解读了日志使用中需要遵循的规范及注意事项，今日进入推送的第三篇阅读，也是终篇。
日志使用示例及常见报错
承接前面两部份，本部份将介绍几种主流日志框架的使用示例和常见的报错。为了便于读者理解，文中的报错案例力求信息完整，并给出了测试代码，感兴趣的读者，可以通过示例快速实践。
日志框架使用示例
Log4j 使用示例
maven 依赖：
log4j
log4j
1.2.17
配置文件：
log4j.properties
### 设置log4j.rootLogger = debug,stdout,INFO### 输出信息到控制台，测试的时候便于观察，实际应用中不配置 ###log4j.appender.stdout = org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.Target = System.outlog4j.appender.stdout.layout = org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n### 输出 INFO 级别以上的日志到指定文件log4j.appender.INFO = org.apache.log4j.DailyRollingFileAppenderlog4j.appender.INFO.File = ~/Code/logs/log4j.loglog4j.appender.INFO.Append = truelog4j.appender.INFO.Threshold = infolog4j.appender.INFO.layout = org.apache.log4j.PatternLayoutlog4j.appender.INFO.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
测试代码：
public class Log4jTest {
private static final Logger LOGGER = Logger.getLogger(Log4jTest.class);
public static void main(String[] args) {
LOGGER.info("log test");
try {
((Object) null).toString();
} catch (Exception e) {
LOGGER.info("exception info", e);
}
LOGGER.info("This is log4j. Thread=" + Thread.currentThread().getName());
}
}
日志输出：
2019-10-31 21:05:36 [ main:0 ] - [ INFO ] log test
2019-10-31 21:05:36 [ main:5 ] - [ INFO ] exception info
java.lang.NullPointerException
at Log4jTest.main(Log4jTest.java:18)
2019-10-31 21:05:36 [ main:9 ] - [ INFO ] This is log4j. Thread=main
commons-logging 使用示例
本例中，使用 Commons-Logging (也称为 JCL) 作为日志门面提供统一的日志接口，Log4j 作为具体的日志实现。
maven 依赖：
commons-logging
commons-logging
1.2
log4j
log4j
1.2.17
配置文件
1. commons-logging.properties
org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger
2. log4j.properties
### 设置
log4j.rootLogger = debug,stdout,INFO
### 输出信息到控制台 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
### 输出 INFO 级别以上的日志到指定文件
log4j.appender.INFO = org.apache.log4j.DailyRollingFileAppender
log4j.appender.INFO.File = ～/Code/logs/jcllog4j.log
log4j.appender.INFO.Append = true
log4j.appender.INFO.Threshold = info
log4j.appender.INFO.layout = org.apache.log4j.PatternLayout
log4j.appender.INFO.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
测试代码：
public class JclTest {
private static final Log LOGGER = LogFactory.getLog(JclTest.class);
public static void main(String[] args) {
LOGGER.info("log test");
try {
((Object) null).toString();
} catch (Exception e) {
LOGGER.info("exception info", e);
}
LOGGER.info("This is jcl log. Thread=" + Thread.currentThread().getName());
}
}
日志输出：
2019-10-31 21:30:42 [ main:0 ] - [ INFO ] log test
2019-10-31 21:30:42 [ main:4 ] - [ INFO ] exception info
java.lang.NullPointerException
at JclTest.main(JclTest.java:19)
2019-10-31 21:30:42 [ main:6 ] - [ INFO ] This is jcl log. Thread=main
slf4j 使用示例
本例中，使用 Slf4j 作为日志门面提供统一的日志接口，Logback 作为具体的日志实现。
maven 依赖：
org.slf4j
slf4j-api
1.7.28
ch.qos.logback
logback-classic
1.2.3
ch.qos.logback
logback-core
1.2.3
配置文件：
logback.xml
logback
DEBUG
%d [%thread] %-5level %logger{36} [%file : %line] - %msg%n
${app.name}/logs/slf4jlogback.log
${app.name}/logs/slf4jlogback.%d{yyyy-MM-dd.HH}.log.gz
60
20GB
100MB
%d [%thread] %-5level %logger{36} [%file : %line] - %msg%n
测试代码：
public class Slf4jTest {
private static final Logger LOGGER = LoggerFactory.getLogger(Slf4jTest.class);
public static void main(String[] args) {
LOGGER.info("log test");
try {
((Object) null).toString();
} catch (Exception e) {
LOGGER.info("exception info", e);
}
LOGGER.info("This is slf4jLogback log. Thread=" + Thread.currentThread().getName());
}
}
日志输出：
019-10-31 21:26:17,806 [main] INFO Slf4jTest [Slf4jTest.java : 17] - log test
2019-10-31 21:26:17,811 [main] INFO Slf4jTest [Slf4jTest.java : 22] - exception info
java.lang.NullPointerException: null
at Slf4jTest.main(Slf4jTest.java:19)
2019-10-31 21:26:17,811 [main] INFO Slf4jTest [Slf4jTest.java : 24] - This is slf4jLogback log. Thread=main
常见报错案例
找不到绑定器
如下图所示，应用使用的是 Slf4j 标准接口，目标日志框架为 Log4j，但是没有引入绑定器(slf4j-log4j12)。
maven 依赖：
org.slf4j
slf4j-api
1.7.28
log4j
log4j
1.2.17
运行测试代码将会报错，提示加载绑定器失败，具体内容如下：
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
配置了多个绑定器
如下图所示，应用使用的是 Slf4j 标准接口，目标日志框架为 Log4j，但是同时引入了两个日志绑定器。
存在问题的 maven 依赖如下所示：
org.slf4j
slf4j-api
1.7.28
log4j
log4j
1.2.17
org.slf4j
slf4j-log4j12
1.7.28
org.apache.logging.log4j
log4j-slf4j-impl
2.12.1
这种情况下，将无法按照预期打印日志，应用会加载默认的日志配置，将日志打印到控制台，详细的错误信息如下：
SLF4J: Class path contains multiple SLF4J bindings.
SLF4J: Found binding in [jar:file:/Users/test/.m2/repository/org/slf4j/slf4j-log4j12/1.7.28/slf4j-log4j12-1.7.28.jar!/org/slf4j/impl/StaticLoggerBinder.class]
SLF4J: Found binding in [jar:file:/Users/test/.m2/repository/org/apache/logging/log4j/log4j-slf4j-impl/2.12.1/log4j-slf4j-impl-2.12.1.jar!/org/slf4j/impl/StaticLoggerBinder.class]
SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation.
SLF4J: Actual binding is of type [org.slf4j.impl.Log4jLoggerFactory]
循环依赖
如下图，应用使用的是 Slf4j 标准接口，目标日志框架为 Log4j，但是同时引入了两个日志绑定器: log4j-over-slf4j 和 slf4j-log4j12，如此将会出现循环依赖。
存在循环依赖问题的 maven 配置如下：
org.slf4j
slf4j-api
1.7.28
log4j
log4j
1.2.17
org.slf4j
slf4j-log4j12
1.7.28
org.slf4j
log4j-over-slf4j
1.7.28
出现循环依赖问题时，日志系统将无法正常启动，进而导致应用无法启动，详细的错误信息如下：
SLF4J: Detected both log4j-over-slf4j.jar AND bound slf4j-log4j12.jar on the class path, preempting StackOverflowError.
SLF4J: See also http://www.slf4j.org/codes.html#log4jDelegationLoop for more details.
Exception in thread "main" java.lang.ExceptionInInitializerError
at org.slf4j.impl.StaticLoggerBinder.(StaticLoggerBinder.java:72)
at org.slf4j.impl.StaticLoggerBinder.(StaticLoggerBinder.java:45)
at org.slf4j.LoggerFactory.bind(LoggerFactory.java:150)
at org.slf4j.LoggerFactory.performInitialization(LoggerFactory.java:124)
at org.slf4j.LoggerFactory.getILoggerFactory(LoggerFactory.java:412)
at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:357)
at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:383)
at Log4jTest.(Log4jTest.java:13)
Caused by: java.lang.IllegalStateException: Detected both log4j-over-slf4j.jar AND bound slf4j-log4j12.jar on the class path, preempting StackOverflowError. See also http://www.slf4j.org/codes.html#log4jDelegationLoop for more details.
at org.slf4j.impl.Log4jLoggerFactory.(Log4jLoggerFactory.java:54)
... 8 more
END
往期精彩文章回顾
进阶之路：Java 日志框架全画传（中）
进阶之路：Java 日志框架全画传（上）
一款云迁移产品的成长史
情感分析技术：让智能客服更懂人类情感
电子书免费下载！1天上手的蓝牙Mesh应用解决方案来袭
语雀的技术架构演进之路
下一代异步 IO 技术解密
io_uring 新异步 IO 机制，性能提升超 150%，堪比 SPDK
如何写好代码？
如何解决大规模高性能存储可靠性问题？
长按扫描二维码关注凌云时刻
每日收获前沿技术与科技洞见