springboot实现邮件发送

SpringBoot-Email

源码

项目说明

本项目演示如何使用SpringBoot框架进行邮件发送。

示例

1、以163邮箱为例，首先进去163邮箱 找到设置 进入POP3/SMTP/IMAP。 开启IMAP/SMTP服务和POP3/SMTP服务，并创建授权密码。（该密码在properties/yml文件中需要配置）

2、pom.xml中引入jar包

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

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <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>
     

3、application.properties配置文件

server.port=8080
#邮件服务器地址
spring.mail.host=smtp.163.com
#用户名
spring.mail.username=xxxx@163.com
#授权密码
spring.mail.password=XXXXXXX

代码示例

• Controller

/**
 * @author : CaoLongMin
 * @version 1.0
 * @since 2021/4/26
 */
@RequestMapping("/email")
@RestController
public class EmailController {


    @Autowired
    private IEmailService iEmailService;
    /**
     * 发送简单邮件
     * @param msg
     * @param email
     * @return
     */
    @PostMapping(value = "/sendSimpleEmail")
    public String sendSimpleEmail(String msg, String email) {


        if (StringUtils.isEmpty(msg) || StringUtils.isEmpty(email)) {
            return "请输入要发送消息和目标邮箱";
        }
        return iEmailService.sendSimpleEmail(msg,email);

    }

    /**
     * 发送html邮件
     * @param msg
     * @param email
     * @return
     */
    @PostMapping(value = "/sendHtmlMsg")
    public String sendHtmlMsg(String msg, String email) {
        if (StringUtils.isEmpty(msg) || StringUtils.isEmpty(email)) {
            return "请输入要发送消息和目标邮箱";
        }
        return iEmailService.sendHtmlMsg(msg,email);

    }

    /**
     * 发送带文件邮件
     * @param msg
     * @param email
     * @return
     */
    @PostMapping(value = "/sendFileEmail")
    public String sendFileEmail(String msg, String email) {
        if (StringUtils.isEmpty(msg) || StringUtils.isEmpty(email)) {
            return "请输入要发送消息和目标邮箱";
        }
        return iEmailService.sendFileEmail(msg,email);

    }

    /**
     * 发送带图片的邮件
     * @param msg
     * @param email
     * @return
     */
    @PostMapping(value = "/sendImgEmail")
    public String sendImgEmail(String msg, String email) {
        if (StringUtils.isEmpty(msg) || StringUtils.isEmpty(email)) {
            return "请输入要发送消息和目标邮箱";
        }
        return iEmailService.sendImgEmail(msg,email);

    }
}

• service.impl

/**
 * @author : CaoLongMin
 * @version 1.0
 * @since 2021/4/26
 */
@Service
public class EmailServiceImpl implements IEmailService {
    @Value("${spring.mail.username}")
    private String sendName;
    @Autowired
    private JavaMailSender mailSender;
    @Override
    public String sendSimpleEmail(String msg, String email) {
        try {
            SimpleMailMessage mail = new SimpleMailMessage();
            mail.setFrom(sendName);
            mail.setCc(sendName);
            mail.setTo(email);
            mail.setSubject("这是一封简单邮件");
            mail.setText(msg);
            mailSender.send(mail);
            return "发送成功";
        } catch (Exception ex) {
            ex.printStackTrace();
            return "发送失败:" + ex.getMessage();
        }
    }

    @Override
    public String sendImgEmail(String msg, String email) {
        try {
            MimeMessage message = mailSender.createMimeMessage();
            MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
            messageHelper.setFrom(sendName);
            messageHelper.setCc(sendName);
            messageHelper.setTo(email);
            messageHelper.setSubject("带静态资源图片的HTML邮件");
            String html = "<div><h1><a name=\"hello\"></a><span>Hello</span></h1><blockquote><p><span>this is a html email.</span></p></blockquote><p>&nbsp;</p><p><span>"
                    + msg + "</span></p><img src='cid:myImg' /></div>";
            messageHelper.setText(html, true);
            File file = new File(ResourceUtils.getURL("classpath:").getPath()+"test.png");
            messageHelper.addInline("myImg", file);
            mailSender.send(message);
            return "发送成功";
        } catch (Exception e) {
            e.printStackTrace();
            return "发送失败：" + e.getMessage();
        }
    }

    @Override
    public String sendFileEmail(String msg, String email) {
        try {
            MimeMessage message = mailSender.createMimeMessage();
            MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
            messageHelper.setFrom(sendName);
            messageHelper.setCc(sendName);
            messageHelper.setTo(email);
            messageHelper.setSubject("一封包含附件的邮件");
            messageHelper.setText(msg);
            File file = new File(ResourceUtils.getURL("classpath:").getPath()+"test.txt");
            messageHelper.addAttachment(file.getName(), file);
            mailSender.send(message);
            return "发送成功";
        } catch (Exception e) {
            e.printStackTrace();
            return "发送失败：" + e.getMessage();
        }
    }

    @Override
    public String sendHtmlMsg(String msg, String email) {
        try {
            MimeMessage message = mailSender.createMimeMessage();
            MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
            messageHelper.setFrom(sendName);
            messageHelper.setCc(sendName);
            messageHelper.setTo(email);
            messageHelper.setSubject("HTML邮件");
            String html = "<div><h1><a name=\"hello\"></a><span>Hello</span></h1><blockquote><p><span>this is a html email.</span></p></blockquote><p>&nbsp;</p><p><span>"
                    + msg + "</span></p></div>";
            messageHelper.setText(html, true);
            mailSender.send(message);
            return "发送成功";
        } catch (MessagingException e) {
            e.printStackTrace();
            return "发送失败：" + e.getMessage();
        }
    }
}

存在问题

1、在发送邮件时可能会报错

com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM 163 smtp13,EcCowAD3PonBcoZgZCtPxg--.17774S2 1619423956,please see http://mail.163.com/help/help_spam_16.htm?ip=59.41.75.142&hostid=smtp13&time=1619423956

可以根据错误代码在 http://mail.163.com/help/help_spam_16.htm?ip=59.41.75.142&hostid=smtp13&time=1619423956 进行查看报错原因
554 DT:SPM错误代码，可在邮件构造时 添加抄送给自己

messageHelper.setCc(sendName);

源码地址