SpringBoot实现邮件推送

最新推荐文章于 2025-10-30 11:49:01 发布

原创

最新推荐文章于 2025-10-30 11:49:01 发布 · 2.9k 阅读

标签

#spring boot #java #后端

SpringBoot实现邮件推送

在项目中经常会遇到SpringBoot推送消息的业务，除了站内推送通知，邮件推送也是一种常见的方式，本次小鹿就带大家实现邮件推送。

引入依赖

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

spring-boot-starter-mail:
- 作用：提供了使用Spring Framework的邮件发送功能的起步依赖。
- 功能：使得在Spring Boot应用中可以轻松地配置和使用邮件发送功能，包括发送简单文本邮件、HTML邮件、附件邮件等。
- 使用：结合Spring的邮件模块，你可以方便地在你的应用程序中集成邮件发送功能，无论是用于发送通知、验证邮件还是其他目的。
spring-boot-starter-thymeleaf:
- 作用：提供了使用Thymeleaf模板引擎的起步依赖。
- 功能：Thymeleaf是一种流行的Java模板引擎，用于在Web应用中创建动态HTML模板。
- 使用：结合Spring Boot和Thymeleaf，你可以使用Thymeleaf的模板语言来生成动态内容，比如渲染服务器端数据到HTML页面上，以便在Web应用中更灵活地展示数据。

在项目中，使用第二个依赖再结合静态的html文件就可以实现，将邮件以预定义模板的形式发送出去。

在实际中只需要将对应的值以Map的方式填入到对应字段中即可，别急~接下来小鹿会带大家实现的。

0_8518639

配置

在项目配置中加入如下配置

yml格式如下:

spring:
  # 邮箱配置
  mail:
    host: smtp.qq.com
    # 用户名 替换成你实际的用户名
    username: test@foxmail.com
    # 授权码 可以去官方申请 不是个人邮箱密码
    password: xxxxxxxxxx

application.properties文件格式如下:

# 需要开启 smtp qq邮箱为例
spring.mail.host=smtp.qq.com
spring.mail.port=465
# 发件人的邮箱
spring.mail.username=xxxxx
# qq 邮箱的第三方授权码 并非个人密码
spring.mail.password=xxxx
#开启ssl 否则 503 错误 但是实际测试发现其实不加也不会报错 但是最好还是加上
spring.mail.properties.mail.smtp.ssl.enable=true

代码具体实现

创建邮件实体封装类

package com.ican.model.dto;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.Map;

/**
 * 邮箱DTO
 * @author xiayexiaolu
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@ApiModel(description = "邮箱DTO")
public class MailDTO {
   
   

    /**
     * 接收者邮箱号
     */
    @ApiModelProperty(value = "接收者邮箱号")
    private String toEmail;

    /**
     * 主题
     */
    @ApiModelProperty(value = "主题")
    private String subject;

    /**
     * 内容
     */
    @ApiModelProperty(value = "内容"