Kafka Consumer/Producer/Streams应用调整日志级别后日志仍输出至stderr问题

1 依赖冲突排查 #

• 执行mvn dependency:tree | grep slf4j 检查项目中slf4j绑定实现是否唯一：Kafka客户端默认携带slf4j-reload4j/slf4j-log4j12绑定，若项目同时引入了logback-classic等其他绑定，会导致log4j配置完全不生效。
• 若项目使用log4j2作为日志框架，需额外引入log4j-slf4j-impl适配包，同时将配置文件重命名为log4j2.properties。

2 配置文件正确性校验 #

• 重点检查ConsoleAppender的Target属性是否显式指定为System.out，未显式配置时log4j的ConsoleAppender默认输出到System.err，这是该问题最常见的诱因。
• 可参考如下最小可用配置验证：

# 根日志配置
log4j.rootLogger=INFO, console
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.Target=System.out
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

# Kafka消费者日志专项配置
log4j.logger.org.apache.kafka.clients.consumer=INFO, console
log4j.additivity.org.apache.kafka.clients.consumer=false

3 配置加载路径校验 #

• 先确认配置文件是否被正确打包到类路径：执行jar tf 你的打包产物.jar | grep log4j 检查jar包根目录是否存在log4j.properties，不存在的话需检查pom.xml的build/resources节点是否过滤了properties后缀的文件。
• 启动时添加参数-Dlog4j.debug=true 运行，控制台会打印log4j配置的完整加载路径，可直接确认是否加载了你编写的配置文件，排除外置配置、容器默认配置优先级更高覆盖本地配置的情况。

4 Kafka版本适配检查 #

• 若使用Kafka 2.4及以上版本，部分官方发行版默认切换为Log4j2作为日志实现，此时log4j.properties配置不会生效，需替换为对应格式的log4j2配置文件。
• 检查消费者初始化代码是否硬编码指定了日志配置路径，覆盖了类路径默认加载逻辑。

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