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

 

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

授权操作流程：

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

b.找到‘账户’：

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

 

OK，接下来开始编码。

瞄一眼最后的目录结构：

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

创建完成后，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 里面的附件路径、图片路径请填写正确（我的图片放在项目里面的）：

 

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

 普通文本邮件：

 带有附件的邮件：

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

 

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