使用 JavaMailSender 发送邮件的详细指南

在现代 Java 应用中，发送邮件是一个常见且重要的功能，尤其在用户注册和密码重置等场景中。Spring 框架提供的 JavaMailSender 接口，可以帮助我们简化这一过程。本文将以 QQ 邮箱为例，详细介绍如何使用 JavaMailSender 发送邮件，并展示具体的代码示例。

1. 引入依赖

首先，确保你的项目中包含了 Spring Boot 和 JavaMail 的相关依赖。如果你使用的是 Maven，可以在 pom.xml 中添加如下依赖：

<dependency>  
    <groupId>org.springframework.boot</groupId>  
    <artifactId>spring-boot-starter-mail</artifactId>  
</dependency>  

2. 配置邮件属性

在 application.properties 或 application.yml 文件中，配置 QQ 邮箱的 SMTP 服务器信息。以下是一个示例配置：

spring.mail.host=smtp.qq.com  
spring.mail.port=587  # 或者使用 465  
spring.mail.username=your-qq-email@qq.com  
spring.mail.password=your-qq-smtp-auth-code  
spring.mail.properties.mail.smtp.auth=true  
spring.mail.properties.mail.smtp.starttls.enable=true  

注意: 使用 QQ 邮箱发送邮件时，需要开启 SMTP 服务并获取授权码，替换 your-qq-smtp-auth-code。可以在 QQ 邮箱的设置中找到该选项。

3. 创建邮件发送服务

接下来，创建一个服务类来处理邮件发送的逻辑。以下是一个示例代码，用于发送包含验证码的注册邮件：

import org.springframework.beans.factory.annotation.Autowired;  
import org.springframework.mail.javamail.JavaMailSender;  
import org.springframework.mail.javamail.MimeMessageHelper;  
import org.springframework.stereotype.Service;  

import javax.mail.internet.MimeMessage;  
import java.util.Date;  

@Service  
public class EmailService {  
    
    @Autowired  
    private JavaMailSender javaMailSender; // 注入 JavaMailSender，用于发送邮件  

    @Autowired  
    private WebConfig webConfig; // 自定义配置类，用于获取发送邮箱等信息  

    public void sendVerificationEmail(String toEmail, String code) {  
        // 创建邮件内容  
        try {  
            // 创建一个 MimeMessage 对象  
            MimeMessage message = javaMailSender.createMimeMessage();  
            
            // 创建一个 MimeMessageHelper 对象，用于简化 MimeMessage 的构建  
            MimeMessageHelper helper = new MimeMessageHelper(message, true);  
            
            helper.setFrom(webConfig.getSendUsername()); // 设置发件人邮箱  
            helper.setTo(toEmail); // 设置收件人邮箱  
            helper.setSubject("注册邮箱验证码"); // 设置邮件主题  
            helper.setText("邮件验证码为：" + code + ", 请尽快注册"); // 设置邮件内容  
            helper.setSentDate(new Date()); // 设置邮件发送日期  

            // 发送邮件  
            javaMailSender.send(message); // 使用 JavaMailSender 发送邮件  
            logger.info("目标邮箱为：{}, 验证码为：{}", toEmail, code); // 记录发送信息  
        } catch (Exception e) {  
            logger.error("发送邮件失败：{}", e.getMessage()); // 记录错误信息  
        }  
    }  
}  

4. 使用服务发送邮件

在需要发送邮件的地方，可以简单地调用 sendVerificationEmail 方法。例如，在用户注册的逻辑中：

// 用户注册逻辑  
String email = "user@example.com";  
String verificationCode = generateVerificationCode(); // 生成验证码  
emailService.sendVerificationEmail(email, verificationCode);  

5. 小结

通过以上步骤，你可以轻松地使用 JavaMailSender 发送电子邮件，特别是利用 QQ 邮箱作为邮件发送的 SMTP 服务器。 JavaMailSender 提供了灵活的邮件发送功能，可以根据需求调整邮件的内容和格式。

注意: 确保你的 QQ 邮箱设置为允许通过 SMTP 发送邮件，并遵循相关的安全和隐私政策。

希望这篇博客能帮助你快速上手 JavaMailSender，实现邮件发送功能，特别是在使用 QQ 邮箱时！如有疑问，请随时询问。