SpringBoot配置Email发送功能实例

本篇介绍在SpringBoot中配置Email服务的具体步骤，以及常见的异常分析。

具体案例以QQ邮箱以及QQ企业邮箱为例。

1. QQ邮箱发送方式
2. QQ企业邮箱发送方式
3. 总结

tips:

下面提到的hashIndex指的是一个元素put到hashmap中时，要根据其key.hashcode & (table.size()-1)来决定其在table中的位置。

table是一个数组，类型为Node。Node是hashmap的一个内部类，用来描述hashmap的元素的一些属性。

1.相关依赖包

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.3.0.RELEASE</version>
</parent>

 <dependencies>
    <!-- springBoot-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <version>1.3.0.RELEASE</version>
    </dependency>
    <!-- email -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-mail</artifactId>
    </dependency>
    <!-- html模板 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-velocity</artifactId>
    </dependency>
</dependencies>

SpringBoot以及mail的依赖包就不做解释了。

这里简单介绍下velocity的作用：

Velocity 是一个基于 Java 的模板引擎框架，提供的模板语言可以使用在 Java 中定义的对象和变量上。

作为邮件模板也是它的一个主要应用场景。

具体用法在下面会进行说明。

2.具体案例

1.使用QQ邮箱进行发送

application.properties

#发送邮箱（可以填你自己的邮箱）
email.from = xxxxxxx@qq.com
#目标邮箱
email.to = 
#邮箱服务器
email.host = smtp.qq.com
#授权码，在QQ邮箱客户端生成
email.auth = kpzmxhrkqklwbbbd

大家可能不理解auth授权码是干什么用的。

这相当于是当以第三方形式登录时用非密码验证的一种手段。

在QQ邮箱->设置->账户 往下拉可以找到。

同时需要把POP3/SMTP服务开启。

JavaMailSender

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.JavaMailSenderImpl;

import javax.mail.Authenticator;
import javax.mail.PasswordAuthentication;
import java.util.Properties;

/**
 * author  : qianweifeng
 * date   : 16/4/9.
 * describe :
 */
@Configuration
public class MailConfig {

  @Autowired
  private Environment env;

  @Bean(name = "JavaMailSender")
  public JavaMailSender getSender(){
    JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();
    javaMailSender.setUsername(env.getProperty(ConfigConstant.EMAIL_FROM));
    javaMailSender.setHost(env.getProperty(ConfigConstant.EMAIL_HOST));
    javaMailSender.setPort(587);//①
    javaMailSender.setDefaultEncoding("UTF-8");
    Properties props = new Properties();//②
    props.setProperty("mail.smtp.host", env.getProperty(ConfigConstant.EMAIL_HOST));
    props.setProperty("mail.smtp.auth", "true");
    javax.mail.Session session = javax.mail.Session.getDefaultInstance(props,new Authenticator(){
      @Override
      protected PasswordAuthentication getPasswordAuthentication(){
        return new PasswordAuthentication("xxxxxx@qq.com",env.getProperty(ConfigConstant.EMAIL_AUTH));
      }
    });
    javaMailSender.setSession(session);//③
    return javaMailSender;
  }

 
}

这是Java邮件发送的一个具体实现Bean。

关于JavaMailSender的内容大家自行看源码或者度娘。

这里说明3个方面。

1.javaMailSender.setPort(587) 这个端口不是随意设置的，根据邮箱服务器以及协议来定的。我在网上找了相关资料，大家参考下：

2.关于Properties的设置。这里只需要设置其邮箱服务器以及启用授权码验证方式即可。

3.session完成的使用授权码验证邮件发送方，相当于建立起一个有效会话。

import com.service.config.ConfigConstant;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.SmartLifecycle;
import org.springframework.core.env.Environment;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.mail.javamail.MimeMessagePreparator;
import org.springframework.stereotype.Component;

import javax.mail.internet.MimeMessage;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicInteger;

/**
 * author  : qianweifeng
 * date   : 16/4/9.
 * describe :
 */
@Component
public class MailUtil implements SmartLifecycle {
  @Autowired
  private JavaMailSender javaMailSender;

  @Autowired
  private Environment env;

  private Logger logger = LoggerFactory.getLogger(MailUtil.class);

  private ScheduledExecutorService service = Executors.newScheduledThreadPool(2);

  private final AtomicInteger count = new AtomicInteger(1);

  public MimeMessagePreparator Send(final String text) {
    MimeMessagePreparator preparator = new MimeMessagePreparator() {
      public void prepare(MimeMessage mimeMessage) throws Exception {
        MimeMessageHelper message = new MimeMessageHelper(mimeMessage);
        message.setTo(env.getProperty(ConfigConstant.EMAIL_TO));
        message.setFrom(env.getProperty(ConfigConstant.EMAIL_FROM));
        message.setSubject("java email send test");
//        String text = VelocityEngineUtils.mergeTemplateIntoString(velocityEngine, "velocity/report.vm", "UTF-8", model);
        message.setText(text, true);
      }
    };
    return preparator;
  }


  @Override
  public boolean isAutoStartup() {
    return true;
  }

  @Override
  public void stop(Runnable runnable) {

  }

  @Override
  public void start() {
    service.scheduleWithFixedDelay(new Runnable() {
      @Override
      public void run() {
        try {
          if (count.get() == 2) {
            service.shutdown();
            logger.info("the task is down");
          }
          logger.info("start send email and the index is " + count);

          javaMailSender.send(Send("test !" + "*" + count.getAndIncrement()));

          logger.info("send email success");
        }catch (Exception e){
          logger.error("send email fail" , e);
        }

      }
    },2000,2000, TimeUnit.MILLISECONDS);
  }

  @Override
  public void stop() {

  }

  @Override
  public boolean isRunning() {
    return false;
  }

  @Override
  public int getPhase() {
    return 0;
  }
}

使用方式：

将邮件服务器，授权码，发送方，接受放在application.properties配置好。

项目启动后就会开始发送，总共发送2封邮件。

使用velocity来构建邮件正文

public void send(final String date, final String date2) {


    final List<UVBean> uVBean = getUV(start, end);
    final List<UserResAndLoginReport> resAndLoginReports = dao.RegisterAndLogin(start, end);

    Map model = new HashMap();
    model.put("uVBean", uVBean);
    model.put("resAndLoginReports", resAndLoginReports);
        String text = VelocityEngineUtils.mergeTemplateIntoString(velocityEngine, "velocity/report.vm", "UTF-8", model);
}

<h3>1.UV</h3>
<TABLE border="1px" style="border-collapse: collapse;">
  <TR>
    <td nowrap="nowarp" style="width:80px;" class="date">日期</td>
    <td nowrap="nowarp" style="width:120px;" class="head">UV</td>
  </TR>
  #foreach( $data in $uVBean )
    <TR>
      <TD nowrap="nowarp" class="date">${data.date}</TD>
      <TD nowrap="nowarp" class="count">${data.data}</TD>
    </TR>
  #end
</TABLE>
...

假设我们需要在邮件中显示的一些复杂内容，可以后台以对象的形式包装起来，放入一个hashmap中，在velocity解析出来，至于如何解析，那就是velocity的语义的问题了。

使用velocity可以在邮件正文中以html的方式来丰富化邮件。

2.使用QQ企业邮箱进行发送

过程以及代码几乎相同

区别是邮件服务器为：smtp.exmail.qq.com或者pop.exmail.qq.com

没有授权码这一概念。

发送端口号25或者SMTP协议下端口为465，POP协议下端口为995。

推荐验证方式为直接用户名+密码，或者用ssl方式进行验证。

具体参考腾讯企业邮箱客户端设置

给出一个简单的样例：

 JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();
    javaMailSender.setUsername(env.getProperty("spring.mail.username"));
    javaMailSender.setHost(env.getProperty("spring.mail.host"));
    javaMailSender.setPassword(env.getProperty("spring.mail.password"));
    javaMailSender.setPort(25);
    javaMailSender.setDefaultEncoding("UTF-8");
    javaMailSender.send(preparator);

preparator就是上面出现过的MimeMessagePreparator的实例。配置方法见上。

3.总结

1.发送邮件我们首要配置的包括：邮箱服务器，协议，端口。

2.一般验证有两种方式，一种是直接的用户名密码，另一种是通过授权码或者ssl进行验证。

3.邮件的正文可以是纯文本，或者是html内容，html内容可以由velocity模板构建或者直接用字符串构建出html内容。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# spring  # boot  # email  # 发送邮件  # springboot整合email  # SpringBoot添加Email发送功能及常见异常详解  # SpringBoot配置发送Email的示例代码  # Spring Boot利用Thymeleaf发送Email的方法教程  # SpringBoot+Email发送邮件的实现示例  # 重学SpringBoot3之如何发送Email邮件功能  # 是一个  # 邮件服务器  # 自己的  # 邮件发送  # 客户端  # 这是  # 这一  # 就会  # 我在  # 放在  # 腾讯  # 要把  # 或者是  # 找了  # 不做  # 只需要  # 可以使用  # 相关资料  # 为例  # 建立起 

相关文章： 如何在IIS中配置站点IP、端口及主机头？  ,sp开头的版面叫什么？  建站之星伪静态规则如何正确配置？  如何在Golang中实现微服务服务拆分_Golang微服务拆分与接口管理方法  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗？  c++23 std::expected怎么用 c++优雅处理函数错误返回【详解】  如何通过山东自助建站平台快速注册域名？  移动端手机网站制作软件,掌上时代，移动端网站的谷歌SEO该如何做？  天河区网站制作公司,广州天河区如何办理身份证？需要什么资料有预约的网站吗？  制作网站建设的公司有哪些,网站建设比较好的公司都有哪些？  建站之家VIP精选网站模板与SEO优化教程整合指南  如何优化Golang Web性能_Golang HTTP服务器性能提升方法  C++如何编写函数模板？（泛型编程入门）  网站制作大概多少钱一个,做一个平台网站大概多少钱？  php8.4新语法match怎么用_php8.4match表达式替代switch【方法】  如何自定义建站之星模板颜色并下载新样式？  建站三合一如何选？哪家性价比更高？  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  如何在阿里云服务器自主搭建网站？  义乌企业网站制作公司,请问义乌比较好的批发小商品的网站是什么？  家庭服务器如何搭建个人网站？  猪八戒网站制作视频,开发一个猪八戒网站，大约需要多少？或者自己请程序员，需要什么程序员，多少程序员能完成？  小型网站建站如何选择虚拟主机？  如何挑选优质建站一级代理提升网站排名？  网站制作知乎推荐,想做自己的网站用什么工具比较好？  独立制作一个网站多少钱,建立网站需要花多少钱？  微网站制作教程,不会写代码，不会编程，怎么样建自己的网站？  实惠建站价格推荐：2025年高性价比自助建站套餐解析  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  如何注册花生壳免费域名并搭建个人网站？  专业网站制作服务公司,有哪些网站可以免费发布招聘信息？  外贸公司网站制作,外贸网站建设一般有哪些步骤？  成都网站制作价格表,现在成都广电的单独网络宽带有多少的，资费是什么情况呢？  如何通过西部建站助手安装IIS服务器？  定制建站如何定义？其核心优势是什么？  官网自助建站系统：SEO优化+多语言支持，快速搭建专业网站  郑州企业网站制作公司,郑州招聘网站有哪些？  高端云建站费用究竟需要多少预算？  建站主机选购指南与交易推荐：核心配置解析  购物网站制作公司有哪些,哪个购物网站比较好？  php条件判断怎么写_ifelse和switchcase的使用区别【对比】  建站主机如何选？高性价比方案全解析  建站之星微信建站一键生成小程序+多端营销系统  制作充值网站的软件,做人力招聘为什么要自己交端口钱？  如何制作一个表白网站视频,关于勇敢表白的小标题？  网站制作免费,什么网站能看正片电影？  如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗？  宝塔建站无法访问？如何排查配置与端口问题？  如何用搬瓦工VPS快速搭建个人网站？  动图在线制作网站有哪些,滑动动图图集怎么做？