Springboot 最简单的发送邮件（文本、附件、图片）实战案例

绝地灬酷狼 2021-11-11 21:36 364阅读 0赞

前言，我们这次的案例使用的是QQ邮箱作为示例，作为发送者需要先开启相关的权限（授权）。

授权操作流程：

a.进入QQ邮箱，点击‘设置’：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70][]

b.找到‘账户’：

![201908061140590.png][]

c.往下拉，找到‘POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务’ ，然后开启第一项‘POP3/SMTP服务’，根据提示发送短信，获取授权码（后面代码配置需要用到）：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 1][]

OK，接下来开始编码。

瞄一眼最后的目录结构：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 2][]

首先创建一个Springboot项目，除了勾选web包，还有 Java Mail Sender包：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 3][]

创建完成后，pom.xml内依赖包如下：

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

接下来是配置参数，application.properties（发送者请填写自己的邮箱或者开通授权的邮箱，配置密码的值是刚刚获取的授权码）：

#SMTP服务器地址
    spring.mail.host=smtp.qq.com
    #SMTP服务器的端口
    spring.mail.port=587
    #邮箱用户名（发送者）
    spring.mail.username=8XXXXXXXX@qq.com  
    #配置密码（发送短信获取的授权码）
    spring.mail.password=dXXXXXXXyitbdea
    #默认的邮件内容编码格式
    spring.mail.default-encoding=UTF-8
    #SSL 加密工厂
    spring.mail.properties.mail.smtp.socketFactoryClass=javax.net.ssl.SSLSocketFactory
    #开启debug，会有相关的日志
    spring.mail.properties.mail.debug=true
    
            
    server.port=8011

到这一步，已经基本完毕，接下来就是使用&调试。

创建一个MailController.java：

package com.mail.elegant.controller;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.core.io.FileSystemResource;
    import org.springframework.mail.MailException;
    import org.springframework.mail.SimpleMailMessage;
    import org.springframework.mail.javamail.JavaMailSender;
    import org.springframework.mail.javamail.MimeMessageHelper;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.mail.MessagingException;
    import javax.mail.internet.MimeMessage;
    import java.io.File;
    import java.util.Date;
    
    /**
     * @Author : JCccc
     * @CreateTime : 2019/8/6
     * @Description :
     **/
    
    @RestController
    public class MailController {
    
        @Autowired
        JavaMailSender javaMailSender;
    
        /**
         * 发送一般的文本邮件
         * @return
         */
        @PostMapping("sendSimpleMailMessage")
        public String sendSimpleMailMessage() {
            try {
                SimpleMailMessage message = new SimpleMailMessage();
                message.setFrom("86447XXXX@qq.com"); //发送邮件的 邮箱地址
                message.setReplyTo("86447XXXX@qq.com");//回复发送至 邮箱地址
                String[] mail={"330809XXXX@qq.com","114737XXXX@qq.com"};
                message.setTo(mail);//邮件接收的 邮箱地址
               // message.setTo("114737XXXX@qq.com");  可以设置多个 多个时采取数组传参
                message.setCc("86447XXXX@qq.com"); //抄送的 邮箱地址      可以设置多个 多个时采取数组传参
                message.setSentDate(new Date());//发送邮件的 日期
                message.setSubject("测试邮件的标题");//发送邮件的标题
                message.setText("你好，我在测试发送邮件。");//发送邮件的 文本内容
    
                javaMailSender.send(message);
            } catch (MailException e) {
                e.printStackTrace();
                return "send fail";
            }
            return "send success";
    
        }
    
    
        /**
         * 发送带有附近的邮件
         * @return
         */
        @PostMapping("sendEnclosureMailMessage")
        public String sendEnclosureMailMessage() {
            try {
                MimeMessage mimeMessage = javaMailSender.createMimeMessage();
                MimeMessageHelper helper = new MimeMessageHelper(mimeMessage,true);
                helper.setSubject("这是一封测试邮件");
                helper.setFrom("86447XXXX@qq.com");
                helper.setTo("330809XXXX@qq.com");
                helper.setCc("86447XXXX@qq.com");
                helper.setBcc("86447XXXX@qq.com");
                helper.setSentDate(new Date());
                helper.setText("这是测试邮件的正文");
                helper.addAttachment("风景.jpg",new File("E:\\elegant\\src\\main\\resources\\pic\\风景.jpg"));
                javaMailSender.send(mimeMessage);
    
            } catch (MailException | MessagingException e) {
                e.printStackTrace();
                return "send fail";
            }
            return "send success";
    
        }
    
        /**
         * 发送内容中带有图片的邮件
         * @return
         */
        @PostMapping("sendImageMailMessage")
        public String sendImageMailMessage() {
            try {
                MimeMessage mimeMessage = javaMailSender.createMimeMessage();
                MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
                helper.setSubject("这是一封测试邮件");
                helper.setFrom("86447XXXX@qq.com");
                helper.setTo("330809XXXX@qq.com");
                helper.setCc("86447XXXX@qq.com");
                helper.setBcc("86447XXXX@qq.com");
                helper.setSentDate(new Date());
                helper.setText("<p>hello 大家好，这是一封测试邮件，里面包含了图片</p><p>图片A：</p><img src='cid:p01'/>",true);
                helper.addInline("p01",new FileSystemResource(new File("E:\\elegant\\src\\main\\resources\\pic\\风景.jpg")));
                javaMailSender.send(mimeMessage);
            } catch (MailException | MessagingException e) {
                e.printStackTrace();
                return "send fail";
            }
            return "send success";
    
        }
    
    
    }

PS:   
1.MailController.java 里面的邮箱地址请正确填写， 只要是setFrom的邮箱地址，必须对应application.properties里面的spring.mail.username  
2.MailController.java 里面的附件路径、图片路径请填写正确（我的图片放在项目里面的）：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 4][]

最后用postman分别调用接口，然后对应的qq邮箱就会收到邮件：

普通文本邮件：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 5][]

带有附件的邮件：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 6][]

文本内容带有图片的邮件：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 7][]

好了，发生邮件教程到此。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70]: /images/20211109/c77509eaffb94d60a7f2d27d4d718579.png
[201908061140590.png]: /images/20211109/98803283632e4882a35271bdb9c44397.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 1]: /images/20211109/365311af425542e6bc3916d7d2f42c97.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 2]: /images/20211109/28077e9136e1423282e2b68576fb6eac.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 3]: /images/20211109/839af856fe4d4fa985baadc63ca4b9af.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 4]: /images/20211109/827e7c3432ad4faf8e20da8e7f1d9fab.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 5]: /images/20211109/59879e836e964fb194fb12ca598132ac.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 6]: /images/20211109/32e342b21f5441e68710dcf3b4862de8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 7]: /images/20211109/fb2d6ff84dbc48c28cd4c003df098514.png