Spring Boot项目SLF4J多绑定：无法切换至Log4j2配置

一、彻底清理SLF4J多绑定冲突 #

• 先揪出所有冲突依赖：
  Maven执行：mvn dependency:tree -Dverbose | grep log
  Gradle执行：./gradlew dependencies | grep log
  找出所有带SLF4J绑定的依赖（比如slf4j-simple、logback-classic这类），在你的依赖声明里逐个排除。
• 确保spring-boot-starter-logging被完全排除：
  Maven示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-logging</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

  Gradle示例：

  implementation('org.springframework.boot:spring-boot-starter-web') {
      exclude group: 'org.springframework.boot', module: 'spring-boot-starter-logging'
  }
  

• 启动项目检查日志：如果还出现SLF4J: Class path contains multiple SLF4J bindings警告，说明还有漏网的绑定依赖，再去依赖树里找。

二、让Log4j2配置文件正常加载 #

• 配置文件位置必须对：放在src/main/resources下，文件名严格匹配以下优先级：
  log4j2.xml > log4j2.properties > log4j2.yaml > log4j2.yml
• 检查配置语法：
  • XML格式要保证标签闭合、命名空间正确，根节点必须是<Configuration>，包含<Appenders>和<Loggers>节点
  • Properties格式要遵循Log4j2的规范，比如appender.console.type = Console，别写错键名
• 强制指定配置路径：自动加载失败的话，在启动参数里加：

  -Dlog4j.configurationFile=classpath:log4j2.xml
  

  或者在application.properties里配置：

  logging.config=classpath:log4j2.xml
  

三、配置ELK转发（以Logstash为例） #

• 先加对Logstash依赖：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-log4j2</artifactId>
  </dependency>
  <!-- Log4j2的Logstash编码器 -->
  <dependency>
      <groupId>net.logstash.log4j</groupId>
      <artifactId>logstash-log4j2-encoder</artifactId>
      <version>7.4</version>
  </dependency>
  

• 在log4j2.xml里添加Logstash Appender：

  <Configuration status="info">
      <Appenders>
          <!-- 控制台输出，方便本地调试 -->
          <Console name="Console" target="SYSTEM_OUT">
              <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
          </Console>
          <!-- 转发到Logstash -->
          <Socket name="Logstash" host="your-logstash-ip" port="5044" protocol="TCP">
              <LogstashLayout/>
          </Socket>
      </Appenders>
      <Loggers>
          <Root level="info">
              <AppenderRef ref="Console"/>
              <AppenderRef ref="Logstash"/>
          </Root>
      </Loggers>
  </Configuration>
  

四、验证配置是否生效 #

• 启动项目后，看控制台日志格式是否和你配置的一致
• 检查Logstash端是否收到日志数据
• 看启动日志里有没有Log4j2 initialized configuration from classpath:log4j2.xml这类提示，没有的话说明配置文件没被加载，再回头查路径和语法

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