Log4j 2.17不兼容Log4j2语法配置，仅支持Log4j1.2语法问题排查

是否仍在使用Log4j 1.2？ #

是的，你的程序确实在使用Log4j 1.2的日志API。判断依据：

• 报错信息以log4j:为前缀，这是Log4j 1.2的专属日志输出格式
• 报错提示指向Log4j 1.2的文档内容
• Log4j2格式的配置文件被加载时，Log4j 1.2的解析器无法识别rootLogger.level这类Log4j2语法，因此提示找不到root logger信息

你已确认项目依赖中无Log4j1.2，但问题大概率出在运行环境（如Spark）自带了Log4j1.2的JAR包，或是第三方依赖（如Hadoop、Spark）间接引入了Log4j1.2，导致运行时类路径中存在Log4j1.2的API。

如何切换为Log4j2语法配置？ #

1. 清理依赖链，仅保留Log4j2相关组件 #

在sbt构建文件中，排除Spark或其他依赖自带的Log4j1.2及SLF4J桥接包，并引入Log4j2的核心组件：

// 排除Spark自带的Log4j1.2和SLF4J-Log4j1.2桥接
libraryDependencies += "org.apache.spark" %% "spark-core" % "你的Spark版本" excludeAll(
  ExclusionRule(organization = "log4j"),
  ExclusionRule(organization = "org.slf4j", name = "slf4j-log4j12")
)

// 引入Log4j2核心、API，以及SLF4J到Log4j2的桥接包
libraryDependencies ++= Seq(
  "org.apache.logging.log4j" % "log4j-api" % "2.17.0",
  "org.apache.logging.log4j" % "log4j-core" % "2.17.0",
  "org.apache.logging.log4j" % "log4j-slf4j-impl" % "2.17.0"
)

2. 指定Log4j2配置文件的JVM参数 #

运行程序时，通过JVM参数明确指定Log4j2的配置文件，避免触发Log4j1.2的配置加载逻辑：

# Spark应用提交示例
spark-submit \
  --class 你的主类全路径 \
  --master 你的集群地址 \
  --conf "spark.driver.extraJavaOptions=-Dlog4j.configurationFile=/etc/spark/conf/log4j2.properties" \
  --conf "spark.executor.extraJavaOptions=-Dlog4j.configurationFile=/etc/spark/conf/log4j2.properties" \
  你的应用JAR包路径

注意：Log4j2的配置参数是log4j.configurationFile，和Log4j1.2的log4j.configuration参数不同，不要混淆。

3. 清理运行环境中的Log4j1.2依赖 #

如果是本地运行或集群环境，检查Spark/Hadoop的lib目录，删除以下文件：

• log4j-1.2*.jar
• slf4j-log4j12-*.jar
  确保环境类路径中只有你引入的Log4j2相关JAR包。

4. 验证切换生效 #

运行程序后，观察日志开头，如果出现StatusLogger前缀的日志（比如INFO StatusLogger Log4j2 initialized），说明Log4j2已正常加载，此时你的Log4j2格式配置文件会被正确解析。

内容的提问来源于stack exchange，提问作者mifan