如何在Spring Boot中配置可正常工作的认证JavaMailSender？

看起来你遇到了Spring Boot中JavaMailSender配置失效的问题——标准JavaMail API能正常发邮件，但Spring Boot配置后既不发送也不报错。我帮你分析下问题所在，以及怎么解决：

核心问题：SSL配置与端口不匹配 #

你使用的是Gmail的587端口，这个端口的标准加密方式是STARTTLS（先建立普通TCP连接，再升级为SSL加密），但你的application.properties里配置了spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory——这个配置会强制JavaMail一开始就用SSL连接587端口，导致连接失败。但因为你的超时配置或者Spring的异常处理逻辑，没有抛出明显的异常信息，才会出现“既不发送也不报错”的情况。

而你用标准JavaMail API的代码虽然也设置了这个socketFactory，但可能是属性组合刚好兼容，不过这并不是587端口的规范用法。

修正后的application.properties配置 #

把socketFactory相关配置替换为STARTTLS启用配置，同时简化不必要的属性：

spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.username=your-email@gmail.com
spring.mail.password=your-app-password # 重要：Gmail开启2FA后必须用应用密码，而非原密码
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true # 启用STARTTLS，适配587端口
spring.mail.properties.mail.smtp.connectiontimeout=5000
spring.mail.properties.mail.smtp.timeout=3000
spring.mail.properties.mail.smtp.writetimeout=5000

额外注意事项 #

• Gmail权限设置：如果你的Gmail账号开启了两步验证，必须使用Google账号的应用密码（在Google账号安全设置里生成）；如果没开2FA，需要开启“不太安全的应用访问”（不过Google现在默认关闭，更推荐开启2FA使用应用密码）。
• 完善异常日志：你的代码里只打印了异常消息me.getMessage()，建议打印完整的堆栈跟踪：

  logger.error("Failed to send email", me);
  

  这样能看到更详细的错误原因，方便排查问题。
• 返回错误状态：当前代码无论成功失败都返回HttpStatus.OK，建议在捕获异常时返回INTERNAL_SERVER_ERROR，让调用方知道发送失败：

  return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
  

调整后的发送代码示例 #

你的核心发送逻辑没问题，完善日志和状态返回后的代码如下：

@Autowired
private JavaMailSender emailSender;

private static final Logger logger = LoggerFactory.getLogger(YourController.class); // 替换为你的控制器类名

@RequestMapping("/sendEmail")
public ResponseEntity<Void> sendEmail(HttpServletRequest httpRequest) {
    try {
        MimeMessage message = emailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message);
        helper.setFrom("sender@gmail.com");
        helper.setTo("recipientaddress@gmail.com");
        helper.setText("This is a test message.");
        helper.setSubject("Test Message");
        emailSender.send(message);
        System.out.println("Email sent successfully");
    } catch (MessagingException me) {
        logger.error("Failed to send email", me);
        return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
    }
    return new ResponseEntity<>(HttpStatus.OK);
}

按照上面的配置和代码调整后，应该就能正常发送邮件了。

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