Spring Boot使用JavaMailSender发送邮件

2022/4/11 17:12:42

编程Tag： spring boot 邮箱邮件 com Mail Helper JavaMailSender

本文主要是介绍Spring Boot使用JavaMailSender发送邮件，对大家解决编程问题具有一定的参考价值，需要的程序猿们随着小编来一起学习吧！

Spring Boot使用JavaMailSender发送邮件

Spring提供了非常好用的JavaMailSender接口实现邮件发送。在Spring Boot的Starter模块中也为此提供了自动化配置。

第一章快速入门

Spring Boot的工程中的pom.xml中引入spring-boot-starter-mail依赖：

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

配置application.properties邮箱的相关属性（注意替换自己的用户名和密码）：

163邮箱为例

spring.mail.host=smtp.163.com
spring.mail.username==用户名
spring.mail.password=密码(授权码，不是邮箱的密码)
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

QQ邮箱为例

spring.mail.host=smtp.qq.com
spring.mail.username=用户名
spring.mail.password=密码(授权码，不是邮箱的密码)
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

通过单元测试来实现一封简单邮件的发送：

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = Application.class)
public class ApplicationTests {
	@Autowired
	private JavaMailSender mailSender;
	@Test
	public void sendSimpleMail() throws Exception {
		SimpleMailMessage message = new SimpleMailMessage();
		message.setFrom("*****@qq.com");
		message.setTo("*****@qq.com");
		message.setSubject("标题：简单邮件");
		message.setText("测试1邮件内容！");
		mailSender.send(message);
	}
}

第二章进阶使用

SimpleMailMessage实现了简单的邮件发送；MimeMessage实现附件、邮件模块等复杂一些的邮件内容发送。

2.1. 发送附件

通过MimeMessageHelper来发送一封带有附件的邮件：

@Test

public void sendAttachmentsMail() throws Exception {

MimeMessage mimeMessage = mailSender.createMimeMessage();

MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);

helper.setFrom("*****@qq.com");

helper.setTo("*****@qq.com");

helper.setSubject("主题：有附件");

helper.setText("有附件的邮件");

FileSystemResource file = new FileSystemResource(new File("weixin.jpg"));

helper.addAttachment("附件-1.jpg", file);

helper.addAttachment("附件-2.jpg", file);

mailSender.send(mimeMessage);

}

2.2. 嵌入静态资源

除了发送附件之外，我们在邮件内容中可能希望通过嵌入图片等静态资源，让邮件获得更好的阅读体验，而不是从附件中查看具体图片，下面的测试用例演示了如何通过MimeMessageHelper实现在邮件正文中嵌入静态资源。

@Test

public void sendInlineMail() throws Exception {

MimeMessage mimeMessage = mailSender.createMimeMessage();

MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);

helper.setFrom("*****@qq.com");

helper.setTo("*****@qq.com");

helper.setSubject("主题：嵌入静态资源");

helper.setText("<html><body><img src=\"cid:weixin\" ></body></html>", true);

FileSystemResource file = new FileSystemResource(new File("weixin.jpg"));

helper.addInline("weixin", file);

mailSender.send(mimeMessage);

}

注意：addInline函数中资源名称weixin需要与正文中cid:weixin对应起来。

2.3. 模板邮件

通常我们使用邮件发送服务的时候，都会有一些固定的场景，比如重置密码、注册确认等，给每个用户发送的内容可能只有小部分是变化的。所以，很多时候我们会使用模板引擎来为各类邮件设置成模板，这样我们只需要在发送时去替换变化部分的参数即可。

在Spring Boot中使用模板引擎来实现模板化的邮件发送也是非常容易的，下面我们以velocity为例实现一下。

引入velocity模块的依赖：

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-velocity</artifactId>

</dependency>

在resources/templates/下，创建一个模板页面template.vm：

<html>

<body>

<h3>你好， ${username}, 这是一封模板邮件!</h3>

</body>

</html>

我们之前在Spring Boot中开发Web应用时，提到过在Spring Boot的自动化配置下，模板默认位于resources/templates/目录下

最后，我们在单元测试中加入发送模板邮件的测试用例，具体如下：

@Test

public void sendTemplateMail() throws Exception {

MimeMessage mimeMessage = mailSender.createMimeMessage();

MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);

helper.setFrom("*******@qq.com");

helper.setTo("*****@qq.com");

helper.setSubject("主题：模板邮件");

Map<String, Object> model = new HashedMap();

model.put("username", "didi");

String text = VelocityEngineUtils.mergeTemplateIntoString(

velocityEngine, "template.vm", "UTF-8", model);

helper.setText(text, true);

mailSender.send(mimeMessage);

}

尝试运行一下，就可以收到内容为你好， didi, 这是一封模板邮件!的邮件。这里，我们通过传入username的参数，在邮件内容中替换了模板中的${username}变量。

https://gitee.com/didispace/SpringBoot-Learning 完整示例：Chapter4-5-1

第三章常见问题

三.1. 邮箱开启授权码

javax.mail.AuthenticationFailedException: 550 User has no permission出错。

三.1.1. 邮箱163设置

163邮箱开启pop3/smtp等协议，然后用授权码代替密码来登陆就可以发送邮件成功。163配置开启pop3/smtp等协议。

1.1. 登录邮箱--设置--选择POP3/SMTP/IMAP

1.2. 开启POP3/SMTP服务

1.3. 按照提示扫码，使用邮箱注册手机号码发短信

3.1.2. 邮箱QQ设置

3.2. 授权码出错导致535错误

javax.mail.AuthenticationFailedException: 535 Error: authentication failed问题解决。开启授权码后依然报这个错，结果是我把授权码写错了；然后项目启动，还是报这个错，再检查发现我把邮箱写错了，所以配置的时候邮箱一定要写正确！

3.3. 邮件在垃圾箱的问题

此问题可能是由于发送的内容是纯文本格式引起的；可以改成html的格式试下，我的就是改了就可以了；

3.4. 遇到554的情况如果是因为文件格式校验不通过不发送邮件的，可以把邮件抄送给发件人一份

3.5. 发送邮件给不同的邮箱(如163\qq\126\139等)，当有html标签时，各个邮箱解析不一样，就会在邮件中显示html标签，所以使用通用的html标签来回车换行和空格，测试兼容(163/qq/139)；

第四章参考材料

https://www.cnblogs.com/ysocean/p/7666061.html

https://www.cnblogs.com/yucongblog/p/7385434.html

这篇关于Spring Boot使用JavaMailSender发送邮件的文章就介绍到这儿，希望我们推荐的文章对大家有所帮助，也希望大家多多支持为之网！

Spring Boot使用JavaMailSender发送邮件

Spring Boot使用JavaMailSender发送邮件

第一章 快速入门

第二章 进阶使用

2.1. 发送附件

2.2. 嵌入静态资源

2.3. 模板邮件

第三章 常见问题

三.1. 邮箱开启授权码

3.2. 授权码出错导致535错误

3.4. 遇到554的情况如果是因为文件格式校验不通过不发送邮件的，可以把邮件抄送给发件人一份

第四章 参考材料

相关编程文章

第一章快速入门

第二章进阶使用

第三章常见问题

第四章参考材料