SpringBoot整合Log4j2 SMTP Appender发送邮件失败求助

1. 依赖完整性检查 #

• 确保Spring Boot整合Log4j2的依赖正确，排除默认Logback：

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

• 补充邮件客户端依赖：Spring Boot 3.x用Jakarta Mail，2.x用javax.mail：

  <!-- Spring Boot 3+ -->
  <dependency>
      <groupId>com.sun.mail</groupId>
      <artifactId>jakarta.mail</artifactId>
  </dependency>
  <!-- Spring Boot 2.x -->
  <dependency>
      <groupId>javax.mail</groupId>
      <artifactId>mail</artifactId>
      <version>1.4.7</version>
  </dependency>
  

• 确认log4j-core与log4j-api版本一致，避免版本冲突。

2. Log4j2配置文件校验 #

• 检查SmtpAppender必填属性是否齐全且格式正确，基础配置示例：

  <Appenders>
      <SMTP name="MailAppender"
            to="收件邮箱@xxx.com"
            from="发件邮箱@xxx.com"
            smtpHost="smtp.xxx.com"
            smtpPort="587"
            smtpUsername="发件邮箱账号"
            smtpPassword="发件邮箱密码/授权码"
            smtpProtocol="smtp"
            smtpDebug="true">
          <ThresholdFilter level="WARN" onMatch="ACCEPT" onMismatch="DENY"/>
          <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
      </SMTP>
  </Appenders>
  <Loggers>
      <Root level="WARN">
          <AppenderRef ref="MailAppender"/>
      </Root>
  </Loggers>
  

• 注意属性名采用驼峰式（如smtpHost而非smtp-host），确保XML标签闭合无语法错误。
• 确认ThresholdFilter或Logger级别设置为WARN/ERROR，满足邮件触发条件。
• 若使用SSL加密，将smtpProtocol设为smtps，端口改为465，确保邮件服务器支持该配置。

3. 环境与代码排查 #

• 测试邮件服务器连通性：在部署机器执行telnet smtp.xxx.com 587（对应端口），确认无防火墙或网络拦截。
• 查看完整错误堆栈：原错误仅提示工厂方法调用失败，后续的Caused by信息会给出具体原因（如依赖缺失、认证失败、配置参数错误等）。
• 排查日志框架冲突：确保项目中未同时引入Logback、SLF4J其他绑定实现类，仅保留Log4j2相关依赖。

内容的提问来源于stack exchange，提问作者Théo