使用Spring Boot发送邮件

最新推荐文章于 2025-06-19 21:42:41 发布
原创 最新推荐文章于 2025-06-19 21:42:41 发布 · 775 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Spring boot发邮件 #邮件带附件

本文介绍如何使用Spring Boot发送简易邮件、Html格式带附件的邮件以及利用Thymeleaf模板引擎发送带附件的邮件。通过详细步骤和代码示例，展示配置、实体类创建以及邮件发送过程，帮助开发者快速掌握这项功能。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

最近没什么事，就试着学习用Spring Boot发送邮件。发现还是很简单的，就写一篇博客记录一下，与大家共享，万一以后要使用呢。

目录：

  1. 发送简易邮件
  2. 发送Html格式的可带附件的邮件
  3. 发送基于thymeleaf模板引擎的可带附件的邮件

POM文件：

在pom文件中添加：

       <lombok.version>1.16.10</lombok.version>

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

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>${lombok.version}</version>
        </dependency>

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

配置文件：

application.properties:

#thymeleaf
spring.thymeleaf.mode=HTML
spring.thymeleaf.cache=false
spring.thymeleaf.prefix=classpath:/templates/

spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
spring.mail.default-encoding=UTF-8
#使用qq发送邮件
spring.profiles.active=qq

application-qq.properties:

# JavaMailSender 邮件发送的配置
spring.mail.host=smtp.qq.com
spring.mail.username=发件人qq
#QQ邮箱的授权码
spring.mail.password=你的qq邮箱授权码

登录QQ邮箱，按下面步骤操作获取授权码
1.
在这里插入图片描述
2.
在这里插入图片描述
3.往下走，开启smtp,获取验证码，如果你之前开启了，就点击下面的生成授权码获取
在这里插入图片描述
application-163.properties:

spring.mail.host=smtp.163.com
spring.mail.username=xxx@163.com
#163邮箱密码
spring.mail.password=xxxxxx

Email实体类：

    private Integer id;
    /** 邮件主题 */
    private String subject;
    /** 邮件显示内容 */
    private String content;
    /** 发送人 */
    private String sender;
    /** 收件人 */
    private String[] recipient;
    /** 抄送人 */
    private String[] cc;
    /** 内容是否是html */
    private boolean isHtml;
    /** 附件列表 一个map存储一个附件的名称和路径 */
    private List<Map<String, String>> attachFiles;
    set/get ...

发送简易邮件：

1.编写一个发送邮件的工具类EmailUtils:添加下面内容

private static final Logger logger = LoggerFactory.getLogger(EmailUtils.class);
    @Autowired
    private JavaMailSender javaMailSender;

    /**
     * 发送简易邮件
     *
     * @param email
     * @return
     */
    public boolean sendSimpleMail(Email email) {
        boolean flag = true;
        try {
            SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
            //发件人
            simpleMailMessage.setFrom(email.getSender());
            //收件人
            simpleMailMessage.setTo(email.getRecipient());
            //抄送人
            simpleMailMessage.setCc(email.getCc());
            //邮件主题
            simpleMailMessage.setSubject(email.getSubject());
            //邮件内容
            simpleMailMessage.setText(email.getContent());
            javaMailSender.send(simpleMailMessage);
        } catch (MailException e) {
            logger.error("邮件发送失败：{}", e.getMessage());
            flag = false;
        }
        return flag;
    }

2.编写单元测试：

    private static final Logger logger = LoggerFactory.getLogger(EmailUtilsTest.class);
    @Autowired
    private EmailUtils emailUtils;
    @Autowired
    private Environment env;
    
    @Test
    public void sendSimpleMail() {
        Email email = new Email();
        email.setSender(env.getProperty("spring.mail.username"));
        email.setRecipient(new String[]{"收件人"});
        email.setCc(new String[]{"抄送人"});
        email.setSubject("主题");
        email.setContent("内容");
        boolean isSend = emailUtils.sendSimpleMail(email);
        logger.info("邮件发送：{}", isSend);
    }

效果如下：
在这里插入图片描述

发送Html格式的可带附件的邮件

1.新建一个常量类保存附件的名称和路径：

	public static final String FILE_NAME = "fileName";
    public static final String FILE_PATH = "filePath";

2.在工具类EmailUtils中添加下面方法：

/**
     * 发送html格式的可带附件的邮件
     * 可多个附件
     *
     * @param email
     */
    public boolean sendHtmlMailWithAttachment(Email email) {
        boolean flag = true;
        try {
            MimeMessage mimeMessage = javaMailSender.createMimeMessage();
            MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true);
            mimeMessageHelper.setSubject(email.getSubject());
            mimeMessageHelper.setText(email.getContent(), email.isHtml());
            mimeMessageHelper.setFrom(email.getSender());
            mimeMessageHelper.setTo(email.getRecipient());
            if (email.getCc() != null) {
                mimeMessageHelper.setCc(email.getCc());
            }
            if (email.getAttachFiles() != null) {
                FileSystemResource file = null;
                for (Map<String, String> attachment : email.getAttachFiles()) {
                    file = new FileSystemResource(attachment.get(FileConstant.FILE_PATH));
                    mimeMessageHelper.addAttachment(attachment.get(FileConstant.FILE_NAME), file);
                }
            }
            javaMailSender.send(mimeMessage);
        } catch (MessagingException e) {
            logger.error("邮件发送失败：{}", e.getMessage());
            flag = false;
        }
        return flag;
    }

3.编写单元测试：

 @Test
    public void sendHtmlMailWithAttachment() {
        Email email = new Email();
        email.setSender(env.getProperty("spring.mail.username"));
        email.setRecipient(new String[]{"收件人"});
        email.setCc(new String[]{"抄送人"});
        email.setSubject("HTML格式的测试邮件");
        email.setContent("<h3><a href='http://www.baidu.com'>百度一下，你就知道</a></h3>");
        email.setHtml(true);
        List<Map<String, String>> maps = new ArrayList<>();
        Map<String, String> map1 = new TreeMap<>();
        map1.put(FileConstant.FILE_NAME, "名称1");
        map1.put(FileConstant.FILE_PATH, "路径1");
        maps.add(map1);
        Map<String, String> map2 = new TreeMap<>();
        map2.put(FileConstant.FILE_NAME, "名称2t");
        map2.put(FileConstant.FILE_PATH, "路径2");
        maps.add(map2);
        Map<String, String> map3 = new TreeMap<>();
        map3.put(FileConstant.FILE_NAME, "名称3");
        map3.put(FileConstant.FILE_PATH, "路径3");
        maps.add(map3);
        email.setAttachFiles(maps);
        boolean isSend = emailUtils.sendHtmlMailWithAttachment(email);
        logger.info("邮件发送：{}", isSend);
    }

效果如下：
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

发送基于thymeleaf模板引擎的可带附件的邮件

1.在resources/templates目录下新建email.html:

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
您好,这是验证邮件,请点击下面的链接完成验证,<br/>
<a th:href="@{${href}}">激活账号</a>
</body>
</html>

2.基于thymeleaf模板引擎发送和前面Html格式的发送其实差不多，只是html格式的邮件是把邮件内容用html代码输入，而thymeleaf模板引擎是获取上下文，设置模板的参数、把解析模板的值作为邮件内容。所以可以复用sendHtmlMailWithAttachment()。
3.编写单元测试

 @Autowired
    private TemplateEngine templateEngine;

    @Test
    public void sendFullMailWithTemplate() {
        Context context = new Context();
        context.setVariable("href", "http://www.baidu.com");
        //解析模板
        String content = templateEngine.process("email", context);

         Email email = new Email();
        email.setSender(env.getProperty("spring.mail.username"));
        email.setRecipient(new String[]{"收件人"});
        email.setCc(new String[]{"抄送人"});
        email.setSubject("HTML格式的测试邮件");
        email.setContent(content );
        email.setHtml(true);
        List<Map<String, String>> maps = new ArrayList<>();
        Map<String, String> map1 = new TreeMap<>();
        map1.put(FileConstant.FILE_NAME, "名称1");
        map1.put(FileConstant.FILE_PATH, "路径1");
        maps.add(map1);
        Map<String, String> map2 = new TreeMap<>();
        map2.put(FileConstant.FILE_NAME, "名称2t");
        map2.put(FileConstant.FILE_PATH, "路径2");
        maps.add(map2);
        Map<String, String> map3 = new TreeMap<>();
        map3.put(FileConstant.FILE_NAME, "名称3");
        map3.put(FileConstant.FILE_PATH, "路径3");
        maps.add(map3);
        email.setAttachFiles(maps);
        boolean isSend = emailUtils.sendHtmlMailWithAttachment(email);
        logger.info("邮件发送：{}", isSend);
    }

效果如下：
在这里插入图片描述
是不是很简单，希望可以帮到正在阅读的你。
如果你有更好想法，欢迎评论。

源码地址：https://github.com/yundiangeqian/email-demo

共同成长，不足之处，请大家指正！！！

Web应用项目开发 ——Spring Boot邮件发送
2301_80760426的博客
12-06 1663
邮件发送是一个非常常见的功能，注册时的身份认证、重要通知发送等都会用到邮件发送。在现代的Web应用程序中，邮件发送功能是非常常见且重要的一部分，Spring Boot框架提供了简单且强大的方式来实现邮件发送功能。Spring中提供了JavaMailsender 用来简化邮件配置，Spring Boot则提供了MailSenderAutoConfguration 对邮件的发送做了进一步简化。下面就分步骤来看一下Spring Boot如何进行邮件发送。
spring boot 发送邮件
Sunday06的博客
07-21 632
准备：发送者需要开启POP3、SMTP协议 需要授权码： （1）添加依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency> （2）在application.yml 配置 spr
springboot发送邮件
09-13
基于springboot发送邮件，包括发送简单文本邮件，发送带html的邮件，发送带有附件的邮件，和thymeleaf集成模板邮件等
springboot(十)：邮件服务
weixin_34414196的博客
06-07 275
springboot仍然在狂速发展，才五个多月没有关注，现在看官网已经到1.5.3.RELEASE版本了。准备慢慢在写写springboot相关的文章，本篇文章使用springboot最新版本1.5.3进行开发。 发送邮件应该是网站的必备功能之一，什么注册验证，忘记密码或者是给用户发送营销信息。最早期的时候我们会使用JavaMail相关api来写发送邮...
SpringBoot扩展——发送邮件！
最新发布
IT_1024的博客
06-19 1103
在日常工作和生活中经常会用到电子邮件。例如，当注册一个新账户时，系统会自动给注册邮箱发送一封激活邮件，通过邮件找回密码，自动批量发送活动信息等。邮箱的使用基本包括这几步：先打开浏览器并登录邮箱，然后创建邮件再发送邮件。在这个过程中有大量的重复性工作且不能批量发送邮件，说明手动的方式效率太低。本节就介绍如何通过代码完成发送邮件的功能。
狂神说：Springboot学习笔记（十三）——异步、定时、邮件任务
LeeBlog
11-11 781
狂神说原文链接 bilibili视频地址 文章目录 前言 一、异步任务 二、定时任务 三、邮件任务 前言 在我们的工作中，常常会用到异步处理任务，比如我们在网站上发送邮件，后台会去发送邮件，此时前台会造成响应不动，直到邮件发送完毕，响应才会成功，所以我们一般会采用多线程的方式去处理这些任务。还有一些定时任务，比如需要在每天凌晨的时候，分析一次前一天的日志信息。还有就是邮件的发送，微信的前身也是邮件服务呢？这些东西都是怎么实现的呢？其实SpringBoot都给我们提供了对应的支持，我们上..
Springboot发送邮件
热门推荐
weixin_46822367的博客
04-01 2万+
一、获取授权码 1、以QQ邮箱为例，页面首部找到设置 2、开启POP3/SMTP服务 3、获取授权码 二、SpringBoot集成邮件发送 1、环境配置 添加依赖 <!-- springboot 邮件mail --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot
Spring Boot发送邮件详解
08-28
2. spring-boot-starter-mail 依赖：在使用 Spring Boot 发送邮件时，需要引入 spring-boot-starter-mail 依赖项，该依赖项提供了邮件发送的相关功能。 3. application.properties 配置：在 application.properties ...
Spring Boot实现邮件发送功能
08-30
在本文中，我们将详细介绍如何使用 Spring Boot 实现邮件发送功能。该功能具有很高的参考价值，对于感兴趣的小伙伴们来说是一个非常实用的参考资源。 知识点一：引入依赖 在实现邮件发送功能之前，我们需要引入...
Spring Boot 发送邮件功能案例分析
08-28
Spring 框架使用 JavaMailSender 接口为发送邮件提供了一个简单的抽象，并且 Spring Boot 也为它提供了自动配置和一个 starter 模块。如果 spring.mail.host 和相关的库（通过 spring-boot-starter-mail 定义）都...
Spring Boot整合邮件发送并保存历史发送邮箱
12-31
和上面对比，这次发送邮件使用 MimeMessageHelper 类。MimeMessageHelper 支持发送复杂邮件模板，支持文本、附件、HTML、图片等，接下来我们会继续使用。 （3）发送带附件的邮件 在 MailService 添加 ...
SpringBoot发送邮件
hello_xing的博客
04-29 201
1.pom.xml中导入xml配置 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency> 2.在application中...
Spring Boot邮件发送实用教程
为了在Spring Boot中发送邮件，我们通常会使用 Spring Framework 提供的 MailSender 接口，它抽象了邮件发送的过程，使得开发者可以将注意力集中在邮件内容的构建上。常用的邮件发送实现有JavaMailSenderImpl，这是...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值