Spring Boot应用中出现Send mail failed. Error message : Authentication failed; nested exception is……

Question

在Spring Boot应用中，当遇到“Send mail failed. Error message : Authentication failed”错误时，通常是邮件服务器认证配置不当所致。以下为常见原因及解决方法： 1. **邮箱账号或密码错误**：检查`spring.mail.username`和`spring.mail.password`是否正确。部分邮箱（如Gmail）需使用应用专用密码而非常规登录密码。 2. **SMTP服务器地址或端口错误**：确保`spring.mail.host`和`spring.mail.port`配置正确。例如，Gmail的SMTP服务器为`smtp.gmail.com`，端口为587（TLS）或465（SSL）。 3. **未启用TLS/SSL**：根据邮件服务商要求，设置`spring.mail.properties.mail.smtp.starttls.enable=true`或`spring.mail.properties.mail.smtp.ssl.enable=true`。 4. **邮件服务商限制**：某些邮箱可能禁止第三方应用登录，需在邮箱安全设置中允许“不太安全的应用”访问。 通过逐一排查以上配置，可有效解决邮件发送失败问题。

Answer 1

1. 问题分析与定位

在Spring Boot应用中，当遇到“Send mail failed. Error message : Authentication failed”错误时，通常是由邮件服务器认证配置不当引起的。以下是逐步排查问题的思路：

• 检查邮箱账号和密码是否正确。
• 确认SMTP服务器地址和端口配置无误。
• 确保启用了TLS/SSL加密。
• 排除邮件服务商对第三方应用登录的限制。

以下章节将详细探讨每种可能的原因及其解决方法。

2. 配置检查与优化

以下是常见原因及解决方案的详细说明：

2.1 邮箱账号或密码错误

首先需要验证`spring.mail.username`和`spring.mail.password`是否正确。对于某些邮箱（如Gmail），需使用应用专用密码而非常规登录密码。

spring:
  mail:
    username: [e-mail]
    password: app-specific-password

如果不确定是否需要应用专用密码，可以参考邮件服务商的帮助文档。

2.2 SMTP服务器地址或端口错误

确保`spring.mail.host`和`spring.mail.port`配置正确。例如，Gmail的SMTP服务器为`smtp.gmail.com`，支持TLS的端口为587，支持SSL的端口为465。

邮件服务商	SMTP服务器地址	TLS端口	SSL端口
Gmail	smtp.gmail.com	587	465
Outlook	smtp.office365.com	587	-

根据实际使用的邮件服务商调整配置。

2.3 未启用TLS/SSL

许多邮件服务商要求使用TLS或SSL加密连接。可以通过以下配置启用：

spring:
  mail:
    properties:
      mail:
        smtp:
          starttls:
            enable: true
          ssl:
            enable: true

启用后，确保应用能够正常连接到SMTP服务器。

3. 排查邮件服务商限制

某些邮件服务商可能禁止第三方应用登录。以Gmail为例，需要在账户的安全设置中允许“不太安全的应用”访问。

以下是操作步骤：

1. 登录Gmail账户。
2. 访问安全设置页面。
3. 开启“允许不够安全的应用”选项。

如果仍然无法解决问题，可以尝试启用两步验证并生成应用专用密码。

4. 故障排查流程图

以下是故障排查的流程图，帮助快速定位问题：

graph TD;
    A[开始] --> B{账号或密码错误?};
    B --是--> C[检查用户名和密码];
    B --否--> D{SMTP地址或端口错误?};
    D --是--> E[确认SMTP配置];
    D --否--> F{TLS/SSL未启用?};
    F --是--> G[启用TLS/SSL];
    F --否--> H{邮件服务商限制?};
    H --是--> I[调整服务商安全设置];
    H --否--> J[联系技术支持];

通过上述流程，可以系统性地解决邮件发送失败的问题。