本文所属【知识林】:http://www.zslin.com/web/article/detail/22

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

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

引入Maven依赖包

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

使用163邮箱发送邮件

  • 配置文件
#JavaMailSender 邮件发送的配置
#spring.mail.host=smtp.exmail.qq.com
spring.mail.host=smtp.163.com
spring.mail.username=username@163.com
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

注意:这里需要将username@163.comyour-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("393156105@qq.com");
        message.setSubject("标题:测试标题");
        message.setText("测试内容部份");
        javaMailSender.send(message);
    }
}

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

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

使用QQ邮箱发送邮件

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

  • 配置文件
#JavaMailSender 邮件发送的配置
spring.mail.host=smtp.qq.com
spring.mail.username=393156105@qq.com
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("393156105@qq.com");
    message.setSubject("标题:测试标题");
    message.setText("测试内容部份");
    javaMailSender.send(message);
}

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

  1. 下载1.7版本的JCE,点击这里
  2. 将下载下来的zip文件中的local_policy.jarUS_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("398986099@qq.com");
        helper.setSubject("标题:发送Html内容");

        StringBuffer sb = new StringBuffer();
        sb.append("<h1>大标题-h1</h1>")
          .append("<p style='color:#F00'>红色字</p>")
          .append("<p style='text-align:right'>右对齐</p>");
        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("2396133790@qq.com");
        helper.setSubject("标题:发送Html内容");

        StringBuffer sb = new StringBuffer();
        sb.append("<h1>大标题-h1</h1>")
                .append("<p style='color:#F00'>红色字</p>")
                .append("<p style='text-align:right'>右对齐</p>");
        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

本文所属【知识林】:http://www.zslin.com/web/article/detail/22
文章点评共:5 条
点评内容: 提交点评

06-02 点评:大

03-06 点评: 报这个错org.springframework.mail.MailSendException: Mail server co nnection failed; nested exception is javax.mail.MessagingException: javax.mail.MessagingException: STARTTLS is required but host does not support STARTTLS(原因是你使用的邮箱没有开启POP3/SMTP/IMAP 的功能)

03-06 回复:查看你的邮箱配置

01-20 点评:我怎么测试都有问题, java.lang.NullPointerException: null

02-04 回复:邮件配置有问题吧

01-05 点评:Could not connect to SMTP host: smtp.163.com, port: 25;

01-10 回复:邮箱设置问题或密码问题

11-12 点评:为什么我一直不能成功 帮忙看看 谢 org.springframework.mail.MailSendException: Mail server co nnection failed; nested exception is javax.mail.MessagingException: javax.mail.MessagingException: STARTTLS is required but host does not support STARTTLS

11-12 回复:没有遇到过这问题!