1、jar包引入
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
2、配置文件
spring.mail.host=smtp.qq.com
spring.mail.username=4052302321@qq.com
#这里切记 password是授权密码 授权密码 授权密码 不是你的邮箱登陆密码
spring.mail.password=xiojtcxgfauybsdf
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
3、核心代码
- (1)定义发送邮件接口
/**
* 发送普通文本邮件
* 我们这里的普通邮件是指最为普通的纯文本邮件
* @param to 收件人
* @param subject 主题
* @param content 内容
*/
void sendSimpleMail(String to, String subject, String content);
/**
* 发送HTML邮件
* HTML文件就是指在文件内容中可以添加<html>等标签,收件人收到邮件后显示内容也和网页一样,比较丰富多彩
* @param to 收件人
* @param subject 主题
* @param content 内容(可以包含<html>等标签)
*/
void sendHtmlMail(String to, String subject, String content);
/**
* 发送带附件的邮件
* 带附件的邮件在HTML邮件上添加一些参数即可
* @param to 收件人
* @param subject 主题
* @param content 内容
* @param filePath 附件路径
*/
void sendAttachmentMail(String to, String subject, String content, String filePath);
/**
* 发送带图片的邮件
* 带图片即在正文中使用<img>标签,并设置我们需要发送的图片,也是在HTML基础上添加一些参数
* @param to 收件人
* @param subject 主题
* @param content 文本
* @param rscPath 图片路径
* @param rscId 图片ID,用于在<img>标签中使用,从而显示图片
*/
void sendInlineResourceMail(String to, String subject, String content, String rscPath, String rscId);
- (2)发送邮件接口实现
@Service("mailService")
public class MailServiceImpl implements MailService {
@Autowired
private JavaMailSender mailSender;
@Value("${spring.mail.username}")
private String from;
@Async//异步
public void sendSimpleMail(String to, String subject, String content) {
SimpleMailMessage message = new SimpleMailMessage();
message.setTo(to);//收信人
message.setSubject(subject);//主题
message.setText(content);//内容
message.setFrom(from);//发信人
mailSender.send(message);
}
public void sendHtmlMail(String to, String subject, String content) {
log.info("发送HTML邮件开始:{},{},{}", to, subject, content);
//使用MimeMessage,MIME协议
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper;
//MimeMessageHelper帮助我们设置更丰富的内容
try {
helper = new MimeMessageHelper(message, true);
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);//true代表支持html
mailSender.send(message);
log.info("发送HTML邮件成功");
} catch (MessagingException e) {
log.error("发送HTML邮件失败:", e);
}
}
public void sendAttachmentMail(String to, String subject, String content, String filePath) {
log.info("发送带附件邮件开始:{},{},{},{}", to, subject, content, filePath);
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper;
try {
helper = new MimeMessageHelper(message, true);
//true代表支持多组件,如附件,图片等
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
FileSystemResource file = new FileSystemResource(new File(filePath));
String fileName = file.getFilename();
helper.addAttachment(fileName, file);//添加附件,可多次调用该方法添加多个附件
mailSender.send(message);
log.info("发送带附件邮件成功");
} catch (MessagingException e) {
log.error("发送带附件邮件失败", e);
}
}
public void sendInlineResourceMail(String to, String subject, String content, String rscPath, String rscId) {
log.info("发送带图片邮件开始:{},{},{},{},{}", to, subject, content, rscPath, rscId);
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper;
try {
helper = new MimeMessageHelper(message, true);
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content, true);
FileSystemResource res = new FileSystemResource(new File(rscPath));
helper.addInline(rscId, res);//重复使用添加多个图片
mailSender.send(message);
log.info("发送带图片邮件成功");
} catch (MessagingException e) {
log.error("发送带图片邮件失败", e);
}
}
}
- (3)发送邮件测试类
@RunWith(SpringRunner.class)
@SpringBootTest
public class MailServiceTest {
@Autowired
private MailService mailService;
/**
* 发送简单纯文本邮件
*/
@Test
public void sendSimpleMail() {
mailService.sendSimpleMail("receiver@email.com", "发送邮件测试", "大家好,这是我用springboot进行发送邮件测试");
}
/**
* 发送HTML邮件
*/
@Test
public void sendHtmlMail() {
String content = "<html><body><h3><font color=\"red\">" + "大家好,这是springboot发送的HTML邮件" + "</font></h3></body></html>";
mailService.sendHtmlMail("receiver@email.com", "发送邮件测试", content);
}
/**
* 发送带附件的邮件
*/
@Test
public void sendAttachmentMail() {
String content = "<html><body><h3><font color=\"red\">" + "大家好,这是springboot发送的HTML邮件,有附件哦" + "</font></h3></body></html>";
String filePath = "your file path";
mailService.sendAttachmentMail("receiver@email.com", "发送邮件测试", content, filePath);
}
/**
* 发送带图片的邮件
*/
@Test
public void sendInlineResourceMail() {
String rscPath = "your picture path";
String rscId = "001";
String content = "<html><body><h3><font color=\"red\">" + "大家好,这是springboot发送的HTML邮件,有图片哦" + "</font></h3>"
+ "<img src=\'cid:" + rscId + "\'></body></html>";
mailService.sendInlineResourceMail("receiver@email.com", "发送邮件测试", content, rscPath, rscId);
}
}
4、错误问题
javax.mail.AuthenticationFailedException: 535 Error: ÇëʹÓÃÊÚȨÂëµÇ¼¡£ÏêÇéÇë¿´:错误解决
这个错的意思是没有成功的连接到发送邮件的服务器地址
private static final String USER = "xxxxxx@qq.com"; // 发件人称号,qq邮箱地址
private static final String PASSWORD = "16位数的授权码"; // qq邮箱,使用的户端授权码
报535错误是因为授权码填写的不对
(1)获取授权码
点击设置–>账户
往下拉,关闭的4个选项全部开启
(2)记住生成的4个授权码,只需要把POP3的授权码写到private static final String PASSWORD = “16位数的授权码”;这里即可。
5、成功案例: