Springboot 之 JavaMailSender发送电子邮件

本文章来自【知识林】

在很多网站系统应用中，电子邮件的发送应该非常常见，如：验证码发送、密码找回邮件发送、事件通知邮件发送等。

下面简单介绍一下在Springboot的开发中如何使用JavaMailSender发送电子邮件。

引入Maven依赖包


    org.springframework.boot
    spring-boot-starter-mail

使用163邮箱发送邮件

配置文件

#JavaMailSender 邮件发送的配置
#spring.mail.host=smtp.exmail.qq.com
spring.mail.host=smtp.163.com
[email protected]
spring.mail.password=your-password
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

注意：这里需要将[email protected]和your-password修改成自己的163的邮箱地址和对应密码

简洁邮件发送

@RunWith(SpringRunner.class)
@SpringBootTest
@ActiveProfiles("163")
public class My163MailTest {

    @Autowired
    private JavaMailSender javaMailSender;

    @Value("${spring.mail.username}")
    private String username;

    @Test
    public void testSendSimple() {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(username);
        message.setTo("[email protected]");
        message.setSubject("标题：测试标题");
        message.setText("测试内容部份");
        javaMailSender.send(message);
    }
}

注意：在setFrom处必须填写自己的邮箱地址，否则会报553错误，不过这里使用了读取配置文件中的配置，则不用修改。

只需要使用@Autowired在private JavaMailSender javaMailSender;上即可通过依赖注入的方式创建出JavaMailSender的对象。

使用QQ邮箱发送邮件

可能使用QQ邮箱发送邮件的情况比较多（大家都在用），下面就个人理解做下简单描述。

配置文件

#JavaMailSender 邮件发送的配置
spring.mail.host=smtp.qq.com
[email protected]
spring.mail.password=tdckceislhfibhbbb
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

注意：在spring.mail.password处的值是需要在邮箱设置里面生成的授权码，这个不是真实的密码。

发送简洁邮件

@Autowired
private JavaMailSender javaMailSender;

@Value("${spring.mail.username}")
private String username;

@Test
public void testSendSimple() {
    SimpleMailMessage message = new SimpleMailMessage();
    message.setFrom(username);
    message.setTo("[email protected]");
    message.setSubject("标题：测试标题");
    message.setText("测试内容部份");
    javaMailSender.send(message);
}

注意：这个例子跟使用163来发送的邮件是一样的效果，但是在使用QQ来发送邮件是可能会报handshake_failure相关的错误，这是由于认证失败导致的，解决办法：

下载1.7版本的JCE，点击这里。
将下载下来的zip文件中的local_policy.jar和US_export_policy.jar复制到JDK安装目录下的\jre\lib\security目录中，原本是存在这两个文件的，这里需要替换下。

发送HTML格式的邮件

@Test
public void testSendHtml() {
    MimeMessage message = null;
    try {
        message = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, true);
        helper.setFrom(username);
        helper.setTo("[email protected]");
        helper.setSubject("标题：发送Html内容");

        StringBuffer sb = new StringBuffer();
        sb.append("大标题-h1")
          .append("红色字")
          .append("右对齐");
        helper.setText(sb.toString(), true);
    } catch (MessagingException e) {
        e.printStackTrace();
    }

    javaMailSender.send(message);
}

注意：这里创建的是MimeMessageHelper，且在调用setText时需要在第二个参数传入true，这样才会使用HTML格式发送邮件

设置收件方显示的名称

@Test
public void testSendByName() {
    MimeMessage message = null;
    try {
        message = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, true);
        helper.setFrom(new InternetAddress(username, "知识林", "UTF-8"));
        helper.setTo("[email protected]");
        helper.setSubject("标题：发送Html内容");

        StringBuffer sb = new StringBuffer();
        sb.append("大标题-h1")
                .append("红色字")
                .append("右对齐");
        helper.setText(sb.toString(), true);
    } catch (Exception e) {
        e.printStackTrace();
    }

    javaMailSender.send(message);
}

注意：与上一个例子基本一样，只是将helper.setFrom(username);修改成helper.setFrom(new InternetAddress(username, "知识林", "UTF-8"));，这样收件方显示的名称就是知识林（前提是收件方没有存发件方邮件）。

示例代码：https://github.com/zsl131/spring-boot-test/tree/master/study12