当前位置：首页 > news >正文

SpringBoot整合Email 邮件发送详解

news 2026/5/11 23:18:19

文章目录

SpringBoot整合Email 邮件发送详解
- 一、引言
- 二、邮件发送需要的配置
- - 1、获取客户端授权码
  - - 163邮箱授权码获取
    - QQ邮箱授权码获取
  - 2、SpringBoot配置SMTP服务
SpringBoot整合Email 邮件发送详解
- 一、引言
- 二、环境准备与配置
- - 1、依赖配置
  - 2、配置文件设置
  - - 163邮箱配置示例
    - QQ邮箱配置示例
- 三、邮件发送实现
- - 1、邮件发送工具类
  - 2、发送普通邮件
  - 3、发送HTML邮件
- 四、总结

SpringBoot整合Email 邮件发送详解

一、引言

在现代软件开发中，邮件服务是应用与用户之间沟通的重要桥梁。无论是发送验证码、通知还是营销邮件，邮件服务都是不可或缺的一部分。SpringBoot作为一个轻量级的Java应用框架，提供了对邮件发送的原生支持，使得开发者可以轻松集成邮件发送功能。本文将详细介绍如何在SpringBoot项目中整合Email服务，包括普通邮件、HTML邮件、含静态资源邮件以及带附件邮件的发送，并给出163和QQ邮箱的配置示例。

二、邮件发送需要的配置

在各大邮件服务商中，为了安全起见，直接使用邮箱账号和密码是无法登录SMTP服务的，我们需要获取对应的客户端授权码。以下是163邮箱和QQ邮箱获取授权码的步骤以及如何在SpringBoot中配置SMTP服务。

1、获取客户端授权码

163邮箱授权码获取

登录163邮箱，进入设置。
选择“账户”选项卡。
向下滚动找到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”，开启“SMTP服务”。
根据提示使用绑定的手机发送短信进行验证。
成功后，可以设置或重置客户端授权码。

QQ邮箱授权码获取

登录QQ邮箱，点击“设置”。
选择“账户”选项卡。
向下滚动找到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”，开启“SMTP服务”。
根据提示进行验证，验证成功后即可看到授权码。

2、SpringBoot配置SMTP服务

在获取授权码后，我们可以在SpringBoot的配置文件中设置SMTP服务。

SpringBoot整合Email 邮件发送详解

一、引言

二、环境准备与配置

1、依赖配置

首先，我们需要在SpringBoot项目的pom.xml文件中添加邮件发送相关的依赖。

<dependencies> <!-- Spring Boot Mail Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency> </dependencies>

2、配置文件设置

接下来，在application.yml或application.properties中配置邮件服务器的信息。

163邮箱配置示例

spring: mail: host: smtp.163.com protocol: smtp default-encoding: UTF-8 username: your-email@163.com password: your-authorization-code properties: mail: smtp: auth: true starttls: enable: true required: true

QQ邮箱配置示例

spring: mail: host: smtp.qq.com protocol: smtp default-encoding: UTF-8 username: your-email@qq.com password: your-authorization-code properties: mail: smtp: auth: true starttls: enable: true required: true

在这里，username和password需要替换为你的邮箱账号和对应的授权码。授权码可以通过登录邮箱服务商的网页版，进入设置获取。

三、邮件发送实现

1、邮件发送工具类

我们创建一个邮件发送的工具类MailUtil，用于封装邮件发送的逻辑。

import org.springframework.beans.factory.annotation.Autowired; import org.springframework.mail.javamail.JavaMailSender; import org.springframework.mail.javamail.MimeMessageHelper; import org.springframework.stereotype.Component; import javax.mail.MessagingException; import javax.mail.internet.MimeMessage; @Component public class MailUtil { @Autowired private JavaMailSender mailSender; public void sendSimpleMail(String to, String subject, String text) throws MessagingException { MimeMessage message = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(message); helper.setFrom("your-email@163.com"); helper.setTo(to); helper.setSubject(subject); helper.setText(text); mailSender.send(message); } public void sendHtmlMail(String to, String subject, String html) throws MessagingException { MimeMessage message = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(message, true); helper.setFrom("your-email@163.com"); helper.setTo(to); helper.setSubject(subject); helper.setText(html, true); mailSender.send(message); } }

2、发送普通邮件

使用MailUtil类，我们可以轻松发送普通文本邮件。

public void sendSimpleMail(String to, String subject, String text) { try { MailUtil mailUtil = new MailUtil(); mailUtil.sendSimpleMail(to, subject, text); System.out.println("邮件发送成功"); } catch (Exception e) { System.out.println("邮件发送失败"); e.printStackTrace(); } }

3、发送HTML邮件

对于HTML邮件，我们只需在setText方法中传入HTML格式的字符串即可。

public void sendHtmlMail(String to, String subject, String html) { try { MailUtil mailUtil = new MailUtil(); mailUtil.sendHtmlMail(to, subject, html); System.out.println("HTML邮件发送成功"); } catch (Exception e) { System.out.println("HTML邮件发送失败"); e.printStackTrace(); } }