Spring Boot实现邮件发送

蔚落 2021-10-19 18:30 418阅读 0赞

### Spring Boot实现邮件发送 ###

*  邮件基础
 *  准备工作
 *  创建项目
 *  基本配置
 *  测试

# 邮件基础 #

我们经常会听到各种各样的邮件协议，比如 SMTP、POP3、IMAP ，那么这些协议有什么作用，有什么区别？我们先来讨论一下这个问题。  
  SMTP 是一个基于 TCP/IP 的应用层协议，江湖地位有点类似于 HTTP，SMTP 服务器默认监听的端口号为 25 。看到这里，小伙伴们可能会想到既然 SMTP 协议是基于 TCP/IP 的应用层协议，那么我是不是也可以通过 Socket 发送一封邮件呢？回答是肯定的。  
  生活中我们投递一封邮件要经过如下几个步骤：  
深圳的小王先将邮件投递到深圳的邮局  
深圳的邮局将邮件运送到上海的邮局  
上海的小张来邮局取邮件  
  这是一个缩减版的生活中邮件发送过程。这三个步骤可以分别对应我们的邮件发送过程，假设从 [aaa@qq.com][aaa_qq.com] 发送邮件到 [111@163.com][111_163.com] ：  
[aaa@qq.com][aaa_qq.com] 先将邮件投递到腾讯的邮件服务器  
腾讯的邮件服务器将我们的邮件投递到网易的邮件服务器  
[111@163.com][111_163.com] 登录网易的邮件服务器查看邮件  
  邮件投递大致就是这个过程，这个过程就涉及到了多个协议，我们来分别看一下。  
  SMTP 协议全称为 Simple Mail Transfer Protocol，译作简单邮件传输协议，它定义了邮件客户端软件与 SMTP 服务器之间，以及 SMTP 服务器与 SMTP 服务器之间的通信规则。  
  也就是说 [aaa@qq.com][aaa_qq.com] 用户先将邮件投递到腾讯的 SMTP 服务器这个过程就使用了 SMTP 协议，然后腾讯的 SMTP 服务器将邮件投递到网易的 SMTP 服务器这个过程也依然使用了 SMTP 协议，SMTP 服务器就是用来收邮件。  
  而 POP3 协议全称为 Post Office Protocol ，译作邮局协议，它定义了邮件客户端与 POP3 服务器之间的通信规则，那么该协议在什么场景下会用到呢？当邮件到达网易的 SMTP 服务器之后， [111@163.com][111_163.com] 用户需要登录服务器查看邮件，这个时候就该协议就用上了：邮件服务商都会为每一个用户提供专门的邮件存储空间，SMTP 服务器收到邮件之后，就将邮件保存到相应用户的邮件存储空间中，如果用户要读取邮件，就需要通过邮件服务商的 POP3 邮件服务器来完成。  
  最后，可能也有小伙伴们听说过 IMAP 协议，这个协议是对 POP3 协议的扩展，功能更强，作用类似，这里不再赘述。

# 准备工作 #

目前国内大部分的邮件服务商都不允许直接使用用户名/密码的方式来在代码中发送邮件，都是要先申请授权码，这里以网易邮箱为例，向大家演示授权码的申请流程：首先我们需要先登录网易邮箱网页版，点击上方的设置按钮：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 1]  
  点击开启，开启相关功能，开启过程需要手机号码验证，按照步骤操作即可，不赘述。开启成功之后，即可获取一个授权码，将该号码保存好，一会使用。

# 创建项目 #

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 2]  
创建完成后依赖如下：

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

# 基本配置 #

配置邮箱基本信息  
项目创建成功后，接下来在 `application.properties` 中配置邮箱的基本信息：

spring.mail.host=smtp.163.com
    spring.mail.port=25
    spring.mail.username=13XXXXXXX12@163.com
    spring.mail.password=123456yjn
    spring.mail.default-encoding=UTF-8
    spring.mail.properties.mail.smtp.socketFactoryClass=javax.net.ssl.SSLSocketFactory
    spring.mail.properties.mail.debug=true

配置含义分别如下：  
配置 SMTP 服务器地址  
SMTP 服务器的端口 163邮箱不用SSL默认25端口，用SSL可用465/994端口  
配置邮箱用户名  
配置密码，注意，不是真正的密码，而是刚刚申请到的授权码  
默认的邮件编码  
配饰 SSL 加密工厂  
表示开启 DEBUG 模式，这样，邮件发送过程的日志会在控制台打印出来，方便排查错误

# 测试 #

@RunWith(SpringRunner.class)
    @SpringBootTest
    public class MailApplicationTests { 
    
        @Autowired
        JavaMailSender javaMailSender;
    
        @Test
        public void contextLoads() { 
            SimpleMailMessage message = new SimpleMailMessage();
            message.setSubject("这是一封测试邮件");
            message.setFrom("13XXXXXXX12@163.com");
            message.setTo("95XXXXX50@qq.com");
            message.setCc("37xxxxx37@qq.com");
        	message.setBcc("14xxxxx098@qq.com");
            message.setSentDate(new Date());
            message.setText("这是测试邮件的正文");
            javaMailSender.send(message);
        }
    }

从上往下，代码含义分别如下：

构建一个邮件对象  
设置邮件主题  
设置邮件发送者  
设置邮件接收者，可以有多个接收者  
设置邮件抄送人，可以有多个抄送人  
设置隐秘抄送人，可以有多个  
设置邮件发送日期  
设置邮件的正文  
发送邮件  
最后执行该方法，就可以实现邮件的发送，发送效果图如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 3]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 4]  
发送成功。

[aaa_qq.com]: mailto:aaa@qq.com
[111_163.com]: mailto:111@163.com
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70]: /images/20211019/c8f4132dc2a54f4faf738b44d8485f61.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 1]: /images/20211019/736e5e37412041ae89622dcec6da1a39.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 2]: /images/20211019/32db477581a54ffeafc05df019cc6a9f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 3]: /images/20211019/178401de7f674cacb3f668ec88e4bc1b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70 4]: /images/20211019/2d22d6a1bcc04e5ab52882fe648e7bda.png