Log4j2 Gmail SMTP Appender问题：无法找到XML格式参数

嘿，我帮你整理下Log4j2 XML格式下SMTP Appender的核心参数，同时针对你给出的配置提几个关键注意点：

核心必填与常用参数 #

这些是配置SMTP Appender时最常用的参数，每个都有明确的作用：

• name: Appender的唯一标识，必须设置，用来在Logger里关联这个Appender
• subject: 邮件主题，支持动态变量（比如${sys:application.name} [PROD] ERROR）
• to: 收件人邮箱，多个收件人用逗号分隔即可
• from: 发件人邮箱地址，要和SMTP认证的用户名匹配
• smtpHost: SMTP服务器地址（比如Gmail的是smtp.gmail.com）
• smtpPort: SMTP服务端口，Gmail常用的是587（STARTTLS）和465（SSL）
• smtpUsername: SMTP认证用的用户名，一般就是发件人邮箱
• smtpPassword: SMTP认证密码，Gmail用户建议用应用专用密码（开启两步验证后才能生成）
• smtpProtocol: 传输协议，选smtp（对应587端口，配合STARTTLS）或smtps（对应465端口，直接SSL加密）
• bufferSize: 触发邮件前缓存的日志条数，默认50，意思是积累50条ERROR日志才发邮件（或者遇到致命错误直接触发）
• filter: 日志过滤规则，比如你用的ThresholdFilter可以只发送ERROR级别及以上的日志

你的配置里的小问题 #

看你当前的配置，有个小冲突需要调整：
你设置了smtpProtocol="smtps"但用了587端口，同时开启了mail.smtp.starttls.enable="true"——这两个配置有点矛盾：

• smtps协议是直接通过SSL连接，对应465端口
• 587端口是先建立明文连接，再通过STARTTLS升级为加密连接，应该用smtp协议

修正后的配置示例 #

这里给你调整成适合587端口的正确配置，还补充了几个建议参数：

<SMTP name="MailAppender"
      subject="Great Notes [PROD] - 系统错误告警"
      to="example@example.com"
      from="example@example.com"
      smtpHost="smtp.gmail.com"
      smtpPort="587"
      bufferSize="50"
      smtpUsername="example@example.com"
      smtpPassword="*********"
      smtpProtocol="smtp"
      mail.smtp.starttls.enable="true"
      mail.smtp.auth="true" <!-- 开启SMTP认证，很多服务器需要这个 -->
      mail.smtp.connectiontimeout="5000" <!-- 连接超时时间，可选 -->
      mail.smtp.timeout="10000"> <!-- 传输超时时间，可选 -->
    <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>
    <PatternLayout>
        <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n%throwable</Pattern>
    </PatternLayout>
</SMTP>

高级可选参数 #

如果有特殊需求，还可以加这些参数：

• cc/bcc: 抄送/密送邮箱，格式和to一样，多个用逗号分隔
• ignoreExceptions: 是否忽略Appender自身的异常，默认true，设为false的话，Appender出错会抛出异常
• layout: 除了PatternLayout，还可以用JsonLayout来发送JSON格式的日志

额外提醒（针对Gmail） #

如果用Gmail的SMTP服务，需要注意：

1. 如果你开启了两步验证，必须用应用专用密码代替普通密码
2. 如果没开两步验证，需要在Google账号设置里开启“不太安全的应用访问”（不过更推荐用两步验证+应用专用密码）

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