暂无图片
暂无图片
暂无图片
暂无图片
暂无图片

log4j配置文件加载逻辑调试方法

解析与重构 2021-01-02
803

使用Spark
开发弹性计算框架时,由于Scala
语言对Spark
的原生支持比较好,所以一般会采用Scala
编写代码。

Scala
底层使用的还是JVM虚拟机,和Java
本身是共通的,所以Log4J
原则上肯定是可以兼容Scala
应用。

Log4J
框架使用配置文件进行日志系统的初始化,由于引入的各类jar
包都有可能会包含Log4J
的配置文件,首次配置起来会比较痛苦。

下面备注下Log4J
框架该如何找到实际生效的配置文件。

1. 包依赖

主要是如下三个包,log4j-api-scala
log4j
scala
环境下使用的桥接包,log4j-api
是应用接入框架的接口定义,log4j-core
是框架核心功能包。

[INFO] +- org.apache.logging.log4j:log4j-api-scala_2.12:jar:11.0:compile
[INFO] +- org.apache.logging.log4j:log4j-api:jar:2.11.2:compile
[INFO] +- org.apache.logging.log4j:log4j-core:jar:2.11.2:compile

2. 初始化堆栈

在应用初始化时,最终会顺着Logger
-> Logging
-> LoggerManager
-> Log4JContextFactory
-> LoggerContext
-> ConfigurationFactory
-> ConfigurationFactory$Factory
的调用链,最终触发对ConfigurationFactory$Factory.getConfiguration
方法的调用。

  • Logger
    :具体的业务Logger类,在实际的业务代码中
  • Logging
    Scala
    trait
    类型,jar -> log4j-api-scala
  • LoggerManager
    :jar -> log4j-api
  • Log4JContextFactory
    :jar -> log4j-core
  • LoggerContext
    :jar -> log4j-core
  • ConfigurationFactory
    :jar -> log4j-core

从调用链看,查找配置文件的核心逻辑在log4j-core
包中。

3. 调用方法

逻辑:

  • 查找带contextName
    (指的是:name
    )的测试类型的配置文件
  • 没有则查找不带contextName
    的测试类型的配置文件
  • 还没有则查找带contextName
    的非测试类型的配置文件
  • 最后再查找不带contextName
    的非测试类型的配置文件

4. 调试断点

  • 类名称:ConfigurationFactory$Factory
  • 方法签名:Configuration getConfiguration(loggerContext, isTest, name)
  • 代码段:log4j-core
    的2.11.2版本在449行,configName
    就是框架尝试加载的配置文件名称,比如log4j.properties这种。
for (final String suffix : types) {
    if (suffix.equals(ALL_TYPES)) {
        continue;
    }
    configName = named ? prefix + name + suffix : prefix + suffix;

    final ConfigurationSource source = ConfigurationSource.fromResource(configName, loader);
    if (source != null) {
        if (!factory.isActive()) {
            LOGGER.warn("Found configuration file {} for inactive ConfigurationFactory {}", configName, factory.getClass().getName());
        }
        return factory.getConfiguration(loggerContext, source);
    }
}

5. 结论

经过debug后确认,在/resources
目录下放置log4j.properties
文件不生效的原因,是因为配置文件名称是log4j2.properties
文件,所以框架根本就没有尝试加载log4j.properties
文件。


文章转载自解析与重构,如果涉嫌侵权,请发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论