在使用Spring Boot集成邮件发送功能时，难免会遇到QQ邮箱认证失败的问题。本文将以实际项目中遇到的错误为例，详细讲解问题原因及两种高效解决方案，让您能轻松配置邮件发送并确保系统稳定运行。
问题背景：Spring Boot邮件发送报错
在项目中，我们的邮件配置文件（YAML格式）如下所示：
spring:
# 邮箱基本配置
mail:
host: smtp.qq.com
username: xxx@qq.com
password: xxx # 在QQ邮箱中生成的授权码
port: 587
default-encoding: UTF-8
properties:
mail:
smtp:
ssl:
enable: false
required: false
debug: true
properties:
mail:
smtp:
ssl:
enable: true # 强制启用SSL加密连接
auth: true # 开启SMTP认证
connectiontimeout: 5000
timeout: 5000
在启动项目后，日志提示如下错误：
2025-04-09 11:53:49.411 ERROR ... Authentication failed; nested exception is javax.mail.AuthenticationFailedException: 530 Login fail. A secure connection is requiered(such as ssl).
错误描述中明确说明：“530 Login fail. A secure connection is requiered(such as ssl)”，也就是说当前配置要求通过安全连接发送邮件，但由于端口和加密协议配置不匹配，导致认证失败。
问题原因解析
QQ邮箱的SMTP服务支持两种主要加密方式：
SSL加密：使用端口465进行加密通信，配置简单且稳定。
STARTTLS加密：使用端口587进行加密通信，需要明确启用STARTTLS，并关闭直接启用SSL。
当前配置中，我们指定端口为587，但存在同时启用了SSL加密的情况，导致服务器要求安全连接，而客户端的配置又不匹配，从而引发认证失败错误。
解决方案一：使用465端口 + SSL加密（推荐）
配置要点
端口：465，QQ邮箱的标准SSL端口。
加密协议：直接启用SSL。
信任目标：通过信任smtp.qq.com的SSL证书，确保连接过程安全。
修改后的YAML配置
spring:
mail:
host: smtp.qq.com
username: xxx@qq.com
password: xxx
port: 465
default-encoding: UTF-8
properties:
mail:
smtp:
ssl:
enable: true
trust: smtp.qq.com # 信任QQ邮箱SSL证书
auth: true
socketFactory:
class: javax.net.ssl.SSLSocketFactory
说明
这样配置后，系统会使用465端口建立SSL加密连接，保证了邮件发送过程中的安全性，同时满足了服务器的认证要求。
解决方案二：保留587端口 + 启用STARTTLS
配置要点
端口：587，这是QQ邮箱支持STARTTLS的端口。
加密协议：关闭直接SSL，启用STARTTLS。
认证：同样需要开启SMTP认证，并可配置socket工厂以增强安全性。
修改后的YAML配置
spring:
mail:
host: smtp.qq.com
username: xxx@qq.com
password: xxx
port: 587
default-encoding: UTF-8
properties:
mail:
smtp:
ssl:
enable: false # 关闭直接启用SSL
starttls:
enable: true # 启用STARTTLS加密
required: true
auth: true
socketFactory:
class: javax.net.ssl.SSLSocketFactory
说明
通过上述配置，客户端将使用STARTTLS升级现有非加密连接，从而实现与服务器之间的数据加密传输。这种方式也能够满足服务器对安全连接的要求，并且适用于那些需要使用587端口的场景。
总结
在使用Spring Boot集成邮件发送时，遇到QQ邮箱认证失败，关键在于正确选择和配置加密方式。
方案一：采用465端口并启用SSL加密，配置更为简单和直接，推荐优先选择。
方案二：保留587端口，关闭直接SSL启用STARTTLS加密，同样能够保障传输安全，但配置稍显复杂。
正确的配置不仅能避免“530 Login fail”错误，还能确保邮件传输的安全性。希望本文能帮助大家快速定位问题，及时调整配置，以便项目平稳运行。
通过理解加密协议和正确设置端口，您也能顺利解决邮箱认证问题，让Spring Boot项目高效稳定地发送邮件。如果在配置中遇到其他问题，欢迎留言讨论！