SpringBoot配置Email发送功能

最新推荐文章于 2024-03-22 09:34:50 发布
原创 最新推荐文章于 2024-03-22 09:34:50 发布 · 1.2w 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#SpringBoot #JavaMail

本文详细介绍如何在SpringBoot项目中配置并使用Email服务，包括QQ邮箱和QQ企业邮箱的配置步骤及常见异常分析。

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

SpringBoot配置Email发送功能

本篇介绍在SpringBoot中配置Email服务的具体步骤，以及常见的异常分析。
具体案例以QQ邮箱以及QQ企业邮箱为例。

  • QQ邮箱发送方式
  • QQ企业邮箱发送方式
  • 总结

tips:
下面提到的hashIndex指的是一个元素put到hashmap中时，要根据其key.hashcode & (table.size()-1)来决定其在table中的位置。

table是一个数组，类型为Node。Node是hashmap的一个内部类，用来描述hashmap的元素的一些属性。

1.相关依赖包

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.3.0.RELEASE</version>
</parent>

 <dependencies>
        <!-- springBoot-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>1.3.0.RELEASE</version>
        </dependency>
        <!-- email -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-mail</artifactId>
        </dependency>
        <!-- html模板 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-velocity</artifactId>
        </dependency>
</dependencies>

SpringBoot以及mail的依赖包就不做解释了。
这里简单介绍下velocity的作用：
Velocity 是一个基于 Java 的模板引擎框架，提供的模板语言可以使用在 Java 中定义的对象和变量上。
作为邮件模板也是它的一个主要应用场景。
具体用法在下面会进行说明。

2.具体案例

1.使用QQ邮箱进行发送

application.properties

#发送邮箱（可以填你自己的邮箱）
email.from = xxxxxxx@qq.com
#目标邮箱
email.to = 
#邮箱服务器
email.host = smtp.qq.com
#授权码，在QQ邮箱客户端生成
email.auth = kpzmxhrkqklwbbbd

大家可能不理解auth授权码是干什么用的。
这相当于是当以第三方形式登录时用非密码验证的一种手段。
在QQ邮箱->设置->账户 往下拉可以找到。
同时需要把POP3/SMTP服务开启。
授权码

JavaMailSender

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.JavaMailSenderImpl;

import javax.mail.Authenticator;
import javax.mail.PasswordAuthentication;
import java.util.Properties;

/**
 * author   : qianweifeng
 * date     : 16/4/9.
 * describe :
 */
@Configuration
public class MailConfig {

    @Autowired
    private Environment env;

    @Bean(name = "JavaMailSender")
    public JavaMailSender getSender(){
        JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();
        javaMailSender.setUsername(env.getProperty(ConfigConstant.EMAIL_FROM));
        javaMailSender.setHost(env.getProperty(ConfigConstant.EMAIL_HOST));
        javaMailSender.setPort(587);//①
        javaMailSender.setDefaultEncoding("UTF-8");
        Properties props = new Properties();//②
        props.setProperty("mail.smtp.host", env.getProperty(ConfigConstant.EMAIL_HOST));
        props.setProperty("mail.smtp.auth", "true");
        javax.mail.Session session = javax.mail.Session.getDefaultInstance(props,new Authenticator(){
            @Override
            protected PasswordAuthentication getPasswordAuthentication(){
                return new PasswordAuthentication("xxxxxx@qq.com",env.getProperty(ConfigConstant.EMAIL_AUTH));
            }
        });
        javaMailSender.setSession(session);//③
        return javaMailSender;
    }

}

这是Java邮件发送的一个具体实现Bean。
关于JavaMailSender的内容大家自行看源码或者度娘。
这里说明3个方面。
1.javaMailSender.setPort(587) 这个端口不是随意设置的，根据邮箱服务器以及协议来定的。我在网上找了相关资料，大家参考下：

2.关于Properties的设置。这里只需要设置其邮箱服务器以及启用授权码验证方式即可。

3.session完成的使用授权码验证邮件发送方，相当于建立起一个有效会话。

import com.service.config.ConfigConstant;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.SmartLifecycle;
import org.springframework.core.env.Environment;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.mail.javamail.MimeMessagePreparator;
import org.springframework.stereotype.Component;

import javax.mail.internet.MimeMessage;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicInteger;

/**
 * author   : qianweifeng
 * date     : 16/4/9.
 * describe :
 */
@Component
public class MailUtil implements SmartLifecycle {
    @Autowired
    private JavaMailSender javaMailSender;

    @Autowired
    private Environment env;

    private Logger logger = LoggerFactory.getLogger(MailUtil.class);

    private ScheduledExecutorService service = Executors.newScheduledThreadPool(2);

    private final AtomicInteger count = new AtomicInteger(1);

    public MimeMessagePreparator Send(final String text) {
        MimeMessagePreparator preparator = new MimeMessagePreparator() {
            public void prepare(MimeMessage mimeMessage) throws Exception {
                MimeMessageHelper message = new MimeMessageHelper(mimeMessage);
                message.setTo(env.getProperty(ConfigConstant.EMAIL_TO));
                message.setFrom(env.getProperty(ConfigConstant.EMAIL_FROM));
                message.setSubject("java email send test");
//                String text = VelocityEngineUtils.mergeTemplateIntoString(velocityEngine, "velocity/report.vm", "UTF-8", model);
                message.setText(text, true);
            }
        };
        return preparator;
    }


    @Override
    public boolean isAutoStartup() {
        return true;
    }

    @Override
    public void stop(Runnable runnable) {

    }

    @Override
    public void start() {
        service.scheduleWithFixedDelay(new Runnable() {
            @Override
            public void run() {
                try {
                    if (count.get() == 2) {
                        service.shutdown();
                        logger.info("the task is down");
                    }
                    logger.info("start send email and the index is " + count);

                    javaMailSender.send(Send("test !" + "*" + count.getAndIncrement()));

                    logger.info("send email success");
                }catch (Exception e){
                    logger.error("send email fail" , e);
                }

            }
        },2000,2000, TimeUnit.MILLISECONDS);
    }

    @Override
    public void stop() {

    }

    @Override
    public boolean isRunning() {
        return false;
    }

    @Override
    public int getPhase() {
        return 0;
    }
}

使用方式：
将邮件服务器，授权码，发送方，接受放在application.properties配置好。
项目启动后就会开始发送，总共发送2封邮件。

使用velocity来构建邮件正文

public void send(final String date, final String date2) {


        final List<UVBean> uVBean = getUV(start, end);
        final List<UserResAndLoginReport> resAndLoginReports = dao.RegisterAndLogin(start, end);

        Map model = new HashMap();
        model.put("uVBean", uVBean);
        model.put("resAndLoginReports", resAndLoginReports);
                String text = VelocityEngineUtils.mergeTemplateIntoString(velocityEngine, "velocity/report.vm", "UTF-8", model);
}
<h3>1.UV</h3>
<TABLE border="1px" style="border-collapse: collapse;">
    <TR>
        <td nowrap="nowarp" style="width:80px;" class="date">日期</td>
        <td nowrap="nowarp" style="width:120px;" class="head">UV</td>
    </TR>
    #foreach( $data in $uVBean )
        <TR>
            <TD nowrap="nowarp" class="date">${data.date}</TD>
            <TD nowrap="nowarp" class="count">${data.data}</TD>
        </TR>
    #end
</TABLE>
...

假设我们需要在邮件中显示的一些复杂内容，可以后台以对象的形式包装起来，放入一个hashmap中，在velocity解析出来，至于如何解析，那就是velocity的语义的问题了。
使用velocity可以在邮件正文中以html的方式来丰富化邮件。
可以参考这篇文章

2.使用QQ企业邮箱进行发送

过程以及代码几乎相同
区别是邮件服务器为：smtp.exmail.qq.com或者pop.exmail.qq.com
没有授权码这一概念。
发送端口号25或者SMTP协议下端口为465，POP协议下端口为995。
推荐验证方式为直接用户名+密码，或者用ssl方式进行验证。
具体参考腾讯企业邮箱客户端设置
给出一个简单的样例：

 JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();
        javaMailSender.setUsername(env.getProperty("spring.mail.username"));
        javaMailSender.setHost(env.getProperty("spring.mail.host"));
        javaMailSender.setPassword(env.getProperty("spring.mail.password"));
        javaMailSender.setPort(25);
        javaMailSender.setDefaultEncoding("UTF-8");
        javaMailSender.send(preparator);

preparator就是上面出现过的MimeMessagePreparator的实例。配置方法见上。

3.总结

1.发送邮件我们首要配置的包括：邮箱服务器，协议，端口。
2.一般验证有两种方式，一种是直接的用户名密码，另一种是通过授权码或者ssl进行验证。
3.邮件的正文可以是纯文本，或者是html内容，html内容可以由velocity模板构建或者直接用字符串构建出html内容。

Java发送邮件 SpringBoot
Bunny的博客
03-17 2182
可以设置发送邮件debug模式这样在发送时可以在控制台中输出相关信息。
SpringBoot下配置动态发送邮箱功能
qq_44627619的博客
11-01 1560
简要:(说的不对的地方欢迎指出) 我们公司系统采用的网易发邮件的方式,所以每个人需要开通 配置信息 1.导入pom文件 <dependency> <groupId>org.glassfish</groupId> <artifactId>javax.mail</artifactId> <version>3.0-b47</version>
SpringBoot-使用JavaMail
sichenss的博客
04-16 469
本篇基于黑马程序员SpringBoot2全套视频教程,springboot零基础到项目实战(SpringBoot2完整版),是自己学习中整理的笔记
Java使用springboot发送邮件
weixin_49128211的博客
10-06 3550
Springboot使用javaMail的QQ邮箱为列，多种邮件发送情况，包含普通文本，带附件、正文携带图片、模板发送等方法。
SpringBoot配置Email发送功能实例
08-30
SpringBoot配置Email发送功能实例 以下是SpringBoot配置Email发送功能实例的知识点总结： 一、 SpringBoot配置Email发送功能实例概述 SpringBoot提供了一个Email发送功能实例，允许开发者轻松地发送电子邮件。该...
SpringBoot添加Email发送功能及常见异常详解
08-30
在Spring Boot应用中，添加Email发送功能是一项常见的需求，它允许开发者向用户或系统接收者发送通知、报告等。本文将详细讲解如何在Spring Boot项目中实现这一功能，并探讨可能出现的常见异常及其解决方法。 首先...
SpringBoot配置发送Email的示例代码
08-29
SpringBoot通过引入spring-boot-starter-mail模块，提供了简单、高效的邮件发送功能，使得开发者可以非常方便地实现邮件发送的功能。 在SpringBoot项目中配置和发送邮件，首先需要在pom.xml文件中添加邮件发送的...
【SpringBoot整合Email发送邮件】
qq_52061700的博客
08-21 792
SpringBoot整合Email发送邮件
springboot集成javamail实现发送邮件功能
02-13
springboot集成javamail，实现发送邮件的功能，可以发送文本类型邮件，也可以发送html格式的邮件，其中整合了mysql、mybatis 具体集成步骤可以参考我的文章： https://www.jianshu.com/p/668d320b4981
SpringBoot整合邮箱JavaMail
08-15
SpringBoot整合JavaMail功能，使用的是Spring自带的发送邮件功能，本Demo以qq邮箱为服务器做的测试，完成了纯文本发送、html发送、嵌入图片、带有附件等的封装，如有不足欢迎交流
springboot配置javaMail
weixin_42881755的博客
12-16 532
简单记录一下后台使用JavaMailSender发送邮件： 导入jar包 spring-boot-starter-mail 配置文件 spring.mail.protocol=smtp spring.mail.host=smtp.mxhichina.com spring.mail.port=465 spring.mail.username= spring.mail.password= spring...
Java技术：SpringBoot实现邮件发送功能
IT技术分享社区
04-12 7857
邮件发送功能基本是每个完整业务系统要集成的功能之一，今天小编给大家介绍一下SpringBoot实现邮件发送功能，希望对大家能有所帮助！今天主要给大家分享简单邮件发送、HTML邮件发送、包含附件的邮件发送三个例子，具体源码链接在文章末尾，有需要的朋友可以自己下载学习一下。1、创建一个基本的SpringBoot项目，pom文件导入发送邮件的依赖&......
Spring Boot 配置 JavaMailSender发送邮件
_William_Cheung的博客
03-07 4695
Spring Boot 配置 JavaMailSender发送邮件： 首先在pom.xml依赖如下：<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency>JavaMailSender邮件发送的配置文
SpringBoot 邮件服务集成配置全面解析
最新发布
ReturnTmp的博客
03-22 1万+
本文以网易邮箱（及 163 邮箱）为例，展示如何为 SpringBoot 项目集成邮件服务，其他邮箱配置类似，可以自行查看Spring Email 指南或是其他官方文档。
7.SpringBoot学习(七)——Spring Boot Email发送邮件
Soulballad的博客
07-19 810
1.简介 1.1 概述 The Spring Framework provides an easy abstraction for sending email by using the JavaMailSender interface, and Spring Boot provides auto-configuration for it as well as a starter module. Spring Framework 通过使用 JavaMailSender 接口提供了用于发送电子邮件的简单抽象
springboot整合javaMail
ssdssa的博客
03-24 2800
SMTP:简单邮件传输协议，用于发送电子邮件的协议 POP3 ( Post Office Protocol - Version3) :用于接收电子邮件的标准协议 IMAP ( Internet Mail Access Protocol) :互联网消息协议，是POP3的替代协议 第一步，引入依赖 <dependency> <groupId>org.springframework.boot</groupId> <ar
SpringBoot 集成邮件服务
码农新锐
02-17 8844
一、前言 1) 互联网发展到现在，相必大家都知道发送邮件应该是网站的必备功能之一:用户注册发送邮箱验证、忘记密码、监控提醒以及发送营销信息等。 2) Spring Email抽象的核心是MailSender接口，MailSender的实现能够把Email发送给邮件服务器，由邮件服务器实现邮件发送的功能。                                           ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值