要在spring boot项目中实现邮件发送功能，首先需添加spring-boot-starter-mail依赖，接着在配置文件中设置邮箱信息如host、port、username和授权码等，然后通过注入javamailsender类编写邮件服务逻辑，最后可通过controller或测试类调用发送邮件。具体步骤为：1. 添加spring boot邮件依赖；2. 配置qq邮箱smtp参数；3. 编写邮件发送服务类；4. 编写controller测试接口并注意常见问题如授权码、端口限制及发件人一致性等。
实现邮件发送功能在Java项目中很常见，比如用户注册通知、订单确认、系统告警等场景。JavaMail 是 Java 提供的一套用于发送和接收电子邮件的 API，结合 Spring Boot 使用更是简单高效。下面我会从配置到代码一步步讲清楚如何用 Java 实现邮件发送。
1. 添加依赖
如果你使用的是 Spring Boot，首先要在 pom.xml 中添加邮件相关的依赖：
org.springframework.boot spring-boot-starter-mail
这个依赖会自动引入 JavaMail 的相关类，并提供对邮件发送的封装。
立即学习“Java免费学习笔记（深入）”；
2. 配置邮箱信息
邮件发送需要一个可用的邮箱账号作为发件人，常见的如 QQ 邮箱、网易邮箱、Gmail 等。以 QQ 邮箱为例，在 application.yml 或 application.properties 中进行如下配置：
application.yml 示例：
spring:
mail:
host: smtp.qq.com
port: 465
username: your-qq@qq.com
password: 授权码（不是登录密码）
protocol: smtp
properties:
mail:
smtp:
ssl:
enable: true几点说明：
-
host：QQ 邮箱的 SMTP 地址是
smtp.qq.com - port：SSL 模式下通常是 465，非 SSL 可能是 25 或 587
- password：不是你的登录密码，而是去邮箱设置里生成的“授权码”
- ssl.enable：QQ 邮箱强制要求启用 SSL 加密
3. 编写邮件发送工具类或 Service
Spring Boot 提供了 JavaMailSender 工具类，我们可以注入它来发送邮件。下面是一个简单的服务类示例：
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;
@Service
public class EmailService {
@Autowired
private JavaMailSender javaMailSender;
public void sendSimpleEmail(String to, String subject, String text) {
SimpleMailMessage message = new SimpleMailMessage();
message.setFrom("your-qq@qq.com"); // 发件人
message.setTo(to); // 收件人
message.setSubject(subject); // 主题
message.setText(text); // 内容
javaMailSender.send(message);
}
}这是一个发送纯文本邮件的方法。如果要发送 HTML 格式的邮件，可以改用 MimeMessage 和 MimeMessageHelper 来构造更复杂的邮件内容。
4. 测试与调用
你可以通过 Controller 或者单元测试来触发邮件发送。例如写一个简单的 Controller：
@RestController
@RequestMapping("/email")
public class EmailController {
@Autowired
private EmailService emailService;
@GetMapping("/send")
public String sendEmail() {
emailService.sendSimpleEmail("someone@example.com", "测试邮件", "这是一封测试邮件，请查收");
return "邮件已发送";
}
}访问 /email/send 接口后，目标邮箱应该就会收到一封测试邮件。
常见问题与注意事项
- 授权码错误：很多同学一开始没搞明白“授权码”是什么，记得去邮箱设置里开启 SMTP 并获取授权码。
- 防火墙或网络限制：有些服务器环境可能限制了 465 端口，需要联系运维确认是否开放。
-
发件人地址不一致：设置的
from必须和你使用的邮箱一致，否则会被拒绝。 - 频繁发送被封号：不要短时间内大量发送邮件，容易被识别为垃圾邮件甚至封号。
基本上就这些。配置看起来有点多，但只要按照步骤一步步来，其实不复杂，只是有些细节容易忽略。
