SpringBoot集成短信和邮件的配置方法
发表于：2025-02-01 作者：千家信息网编辑
千家信息网最后更新 2025年02月01日，本文小编为大家详细介绍"SpringBoot集成短信和邮件的配置方法"，内容详细，步骤清晰，细节处理妥当，希望这篇"SpringBoot集成短信和邮件的配置方法"文章能帮助大家解决疑惑，下面跟着小编的
千家信息网最后更新 2025年02月01日SpringBoot集成短信和邮件的配置方法
本文小编为大家详细介绍"SpringBoot集成短信和邮件的配置方法"，内容详细，步骤清晰，细节处理妥当，希望这篇"SpringBoot集成短信和邮件的配置方法"文章能帮助大家解决疑惑，下面跟着小编的思路慢慢深入，一起来学习新知识吧。
准备工作
1、集成邮件
以QQ邮箱为例
在发送邮件之前，要开启POP3和SMTP协议，需要获得邮件服务器的授权码，获取授权码：
1、设置>账户
在账户的下面有一个开启SMTP协议的开关并进行密码验证：
2、获取成功的授权码
2、集成短信
以阿里云短信服务为例
1、登陆阿里云—>进入控制台—>开通短信服务
进入后根据提示开通短信服务即可。
2、充值
后期发短信测试需要，暂时可以跳过此步骤。
3、获取AccessKey和AccessSercet
4、API
依赖
1、邮件
org.springframework.boot spring-boot-starter-mail
2、短信
com.aliyun dysmsapi20170525 2.0.4
配置
1、配置邮箱基本信息
spring: mail: # 配置 SMTP 服务器地址 host: smtp.qq.com # 发送者邮箱 username: 742354529@qq.com # 配置密码，注意不是真正的密码，而是申请的授权码 password: vjstfghblprwbdbd # 端口号465或587 port: 587 # 默认的邮件编码为UTF-8 default-encoding: UTF-8 # 配置SSL 加密工厂 properties: mail: smtp: socketFactoryClass: javax.net.ssl.SSLSocketFactory # 表示开启DEBUG模式，邮件发送过程的日志会在控制台打印出来 debug: true
SMTP 服务器地址
126邮箱SMTP服务器地址:smtp.126.com,端口号:465或者994
2163邮箱SMTP服务器地址:smtp.163.com,端口号:465或者994
yeah邮箱SMTP服务器地址:smtp.yeah.net,端口号:465或者994
qq邮箱SMTP服务器地址：smtp.qq.com,端口号465或587*
2、短信配置
# 阿里云短信配置sms: access-id: LTAI5tDP3SDQC9yvCguiiFDr access-key: EGSDQsLxCVS5dwjS8DCxmYQ124XySV sign-name: endpoint: dysmsapi.aliyuncs.com
编码
1、邮件
1.1、MailService.java
package com.tanersci.service;import com.tanersci.dto.MailMessageDto;import com.tanersci.vo.MessageVo;/** * @ClassName： MailService.java * @ClassPath： com.tanersci.service.MailService.java * @Description： 邮件 * @Author： tanyp * @Date： 2021/6/7 9:18 **/public interface MailService { /** * @MonthName： sendSimple * @Description： 普通邮件发送 * @Author： tanyp * @Date： 2021/6/7 9:30 * @Param： [dto] * @return： void **/ MessageVo sendSimple(MailMessageDto dto); * @MonthName： sendAttachFile * @Description： 带附件的邮件 MessageVo sendAttachFile(MailMessageDto dto); * @MonthName： sendImgRes * @Description： 带图片资源的邮件 MessageVo sendImgRes(MailMessageDto dto);}1.2、MailServiceImpl.java
package com.tanersci.service.impl;import com.alibaba.fastjson.JSON;import com.tanersci.dto.MailMessageDto;import com.tanersci.vo.MessageVo;import com.tanersci.constant.Constants;import com.tanersci.service.MailService;import lombok.extern.slf4j.Slf4j;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.beans.factory.annotation.Value;import org.springframework.core.io.FileSystemResource;import org.springframework.mail.MailException;import org.springframework.mail.SimpleMailMessage;import org.springframework.mail.javamail.JavaMailSender;import org.springframework.mail.javamail.MimeMessageHelper;import org.springframework.stereotype.Service;import javax.mail.MessagingException;import javax.mail.internet.MimeMessage;import java.time.LocalDateTime;import java.util.Date;import java.util.Objects;/** * @ClassName： MailServiceImpl.java * @ClassPath： com.tanersci.service.impl.MailServiceImpl.java * @Description： 邮件 * @Author： tanyp * @Date： 2021/6/7 9:18 **/@Slf4j@Servicepublic class MailServiceImpl implements MailService { @Value("${spring.mail.username}") private String sender; @Autowired private JavaMailSender javaMailSender; /** * @MonthName： sendSimple * @Description： 普通邮件发送 * @Author： tanyp * @Date： 2021/6/7 9:30 * @Param： [dto] * @return： void **/ @Override public MessageVo sendSimple(MailMessageDto dto) { try { log.info("=======普通邮件发送开始，请求参数：{}", JSON.toJSON(dto)); // 构建一个邮件对象 SimpleMailMessage message = new SimpleMailMessage(); // 设置邮件主题 message.setSubject(dto.getSubject()); // 设置邮件发送者，这个跟application.yml中设置的要一致 message.setFrom(sender); // 设置邮件接收者，可以有多个接收者，中间用逗号隔开，以下类似 // message.setTo("10*****16@qq.com","12****32*qq.com"); message.setTo(dto.getRecipient()); // 设置邮件抄送人，可以有多个抄送人 if (Objects.nonNull(dto.getCc())) { message.setCc(dto.getCc()); } // 设置隐秘抄送人，可以有多个 if (Objects.nonNull(dto.getBcc())) { message.setBcc(dto.getBcc()); // 设置邮件发送日期 message.setSentDate(new Date()); // 设置邮件的正文 message.setText(dto.getText()); // 发送邮件 javaMailSender.send(message); log.info("=======普通邮件发送结束"); return MessageVo.builder().code(Constants.NEWS_SUCCESS_CODE).message(Constants.NEWS_SUCCESS_MESSAGE).build(); } catch (MailException e) { log.error("====邮件====sendSimple=====异常：{}", e); return MessageVo.builder().code(Constants.NEWS_FAIL_CODE).message(Constants.NEWS_FAIL_MESSAGE).build(); } } * @MonthName： sendAttachFile * @Description： 带附件的邮件 public MessageVo sendAttachFile(MailMessageDto dto) { log.info("=======带附件的邮件开始，请求参数：{}", JSON.toJSON(dto)); MimeMessage mimeMessage = javaMailSender.createMimeMessage(); // true表示构建一个可以带附件的邮件对象 MimeMessageHelper message = new MimeMessageHelper(mimeMessage, true); // 第一个参数是自定义的名称，后缀需要加上，第二个参数是文件的位置 dto.getAttachments().forEach(file -> { try { message.addAttachment(file.getName(), file); } catch (MessagingException e) { log.error("=========邮件附件解析异常：{}", e); } }); javaMailSender.send(mimeMessage); log.info("=======带附件的邮件结束"); } catch (MessagingException e) { log.error("==========邮件====sendAttachFile=====异常：{}", e); * @MonthName： sendImgRes * @Description： 带图片资源的邮件 public MessageVo sendImgRes(MailMessageDto dto) { log.info("=======带图片资源的邮件开始，请求参数：{}", JSON.toJSON(dto)); // 第一个参数指的是html中占位符的名字，第二个参数就是文件的位置 message.addInline(file.getName(), new FileSystemResource(file)); log.error("=========邮件图片解析异常：{}", e); log.info("=======带图片资源的邮件结束"); log.error("====邮件====sendImgRes=====异常：{}", e);}1.3、VO、DTO及常量类
MailMessageDto.java
package com.tanersci.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.io.File;import java.io.Serializable;import java.util.List;/** * @ClassName： MailMessageDto.java * @ClassPath： com.tanersci.dto.MailMessageDto.java * @Description： 邮件消息 * @Author： tanyp * @Date： 2021/6/7 9:20 **/@Data@AllArgsConstructor@NoArgsConstructor@Builder@ApiModel(value = "邮件消息")public class MailMessageDto implements Serializable { private static final long serialVersionUID = 5483400172436286831L; @ApiModelProperty(value = "邮件主题") private String subject; @ApiModelProperty(value = "接收者：可以有多个接收者，中间用逗号隔开") private String recipient; @ApiModelProperty(value = "抄送人：可以有多个抄送人，中间用逗号隔开") private String cc; @ApiModelProperty(value = "隐秘抄送人：可以有多个抄送人，中间用逗号隔开") private String bcc; @ApiModelProperty(value = "正文") private String text; @ApiModelProperty(value = "模板编码") private String code; @ApiModelProperty(value = "附件、图片") private List attachments;} MessageVo.java
package com.tanersci.vo;import io.swagger.annotations.ApiModel;import io.swagger.annotations.ApiModelProperty;import lombok.AllArgsConstructor;import lombok.Builder;import lombok.Data;import lombok.NoArgsConstructor;import java.io.Serializable;/** * @ClassName： MessageVo.java * @ClassPath： com.tanersci.vo.MessageVo.java * @Description： 短信、邮件消息返回值 * @Author： tanyp * @Date： 2021/6/7 11:35 **/@Data@AllArgsConstructor@NoArgsConstructor@Builder@ApiModel(value = "短信、邮件消息返回值")public class MessageVo implements Serializable { private static final long serialVersionUID = 5287525465339500144L; @ApiModelProperty(value = "状态码") private String code; @ApiModelProperty(value = "状态码的描述") private String message; @ApiModelProperty(value = "请求ID") private String requestId; @ApiModelProperty(value = "发送回执ID") private String bizId; @ApiModelProperty(value = "模板编码") private String templateCode;}Constants.java
package com.tanersci.constant;/** * @ClassName： Constants.java * @ClassPath： com.tanersci.constant.Constants.java * @Description： 常量 * @Author： tanyp * @Date： 2021/5/22 15:54 **/public class Constants { /** * 消息发送状态码 */ public final static String NEWS_SUCCESS_CODE = "OK"; public final static String NEWS_SUCCESS_MESSAGE = "发送成功"; public final static String NEWS_FAIL_CODE = "FAIL"; public final static String NEWS_FAIL_MESSAGE = "发送失败";}2、短信
2.1、SmsService.java
package com.tanersci.service;import com.tanersci.dto.SmsMessageDto;import com.tanersci.dto.SmsTemplateDto;import com.tanersci.vo.MessageVo;/** * @ClassName： SmsService.java * @ClassPath： com.tanersci.service.SmsService.java * @Description： 短信 * @Author： tanyp * @Date： 2021/6/7 10:56 **/public interface SmsService { /** * @MonthName： send * @Description： 发短信 * @Author： tanyp * @Date： 2021/6/7 14:50 * @Param： [dto] * @return： com.tanersci.vo.MessageVo **/ MessageVo send(SmsMessageDto dto); * @MonthName： addSmsTemplate * @Description： 申请短信模板 * @Param： [template] MessageVo addSmsTemplate(SmsTemplateDto template); * @MonthName： deleteSmsTemplate * @Description： 删除短信模板 MessageVo deleteSmsTemplate(SmsTemplateDto template); * @MonthName： modifySmsTemplate * @Description： 修改未通过审核的短信模板 MessageVo modifySmsTemplate(SmsTemplateDto template); * @MonthName： querySmsTemplate * @Description： 查询短信模板的审核状态 MessageVo querySmsTemplate(SmsTemplateDto template);}2.2、SmsServiceImpl.java
package com.tanersci.service.impl;import com.alibaba.fastjson.JSON;import com.aliyun.dysmsapi20170525.Client;import com.aliyun.dysmsapi20170525.models.*;import com.aliyun.teaopenapi.models.Config;import com.tanersci.dto.SmsMessageDto;import com.tanersci.dto.SmsTemplateDto;import com.tanersci.vo.MessageVo;import com.tanersci.config.SmsConfig;import com.tanersci.constant.Constants;import com.tanersci.service.SmsService;import lombok.extern.slf4j.Slf4j;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Service;import java.time.LocalDateTime;import java.util.Objects;import java.util.UUID;/** * @ClassName： SmsServiceImpl.java * @ClassPath： com.tanersci.service.impl.SmsServiceImpl.java * @Description： 短信 * @Author： tanyp * @Date： 2021/6/7 10:57 **/@Slf4j@Servicepublic class SmsServiceImpl implements SmsService { @Autowired private SmsConfig smsConfig; /** * @MonthName： createClient * @Description： SK初始化账号Client * @Author： tanyp * @Date： 2021/6/7 15:44 * @Param： [accessId, accessKey, endpoint] * @return： com.aliyun.teaopenapi.Client **/ public Client createClient() throws Exception { Config config = new Config(); config.accessKeyId = smsConfig.getAccessId(); config.accessKeySecret = smsConfig.getAccessKey(); config.endpoint = smsConfig.getEndpoint(); return new Client(config); } * @MonthName： send * @Description： 发短信 * @Date： 2021/6/7 14:50 * @Param： [dto] * @return： com.tanersci.vo.MessageVo @Override public MessageVo send(SmsMessageDto dto) { try { log.info("======发送短信开始，请求参数：{}", JSON.toJSON(dto)); Client client = createClient(); // 组装请求对象 SendSmsRequest request = new SendSmsRequest(); // 外部流水扩展字段 String outId = UUID.randomUUID().toString(); request.setOutId(outId); // 支持对多个手机号码发送短信，手机号码之间以英文逗号（,）分隔。上限为1000个手机号码。批量调用相对于单条调用及时性稍有延迟。 request.setPhoneNumbers(dto.getPhone()); // 短信签名名称 request.setSignName(smsConfig.getSignName()); // 短信模板ID request.setTemplateCode(dto.getTemplateCode()); // 短信模板变量对应的实际值，JSON格式。如果JSON中需要带换行符，请参照标准的JSON协议处理。 request.setTemplateParam(JSON.toJSONString(dto.getParam())); // 发送短信 SendSmsResponse res = client.sendSms(request); MessageVo message = MessageVo.builder().build(); if (Objects.equals(Constants.NEWS_SUCCESS_CODE, res.body.getCode())) { log.info("======发送短信成功，返回值：{}", JSON.toJSON(res.body)); message.setCode(Constants.NEWS_SUCCESS_CODE); message.setMessage(Constants.NEWS_SUCCESS_MESSAGE); } else { log.info("======发送短信失败，返回值：{}", JSON.toJSON(res.body)); message.setCode(Constants.NEWS_FAIL_CODE); message.setMessage(Constants.NEWS_FAIL_MESSAGE); } return message; } catch (Exception e) { log.error("======发送短信异常：{}", e.getMessage()); e.printStackTrace(); return MessageVo.builder().code(Constants.NEWS_FAIL_CODE).message(Constants.NEWS_FAIL_MESSAGE).build(); } * @MonthName： addSmsTemplate * @Description： 申请短信模板 * @Param： [template] public MessageVo addSmsTemplate(SmsTemplateDto template) { log.info("======申请短信模板，请求参数：{}", JSON.toJSON(template)); AddSmsTemplateRequest request = new AddSmsTemplateRequest(); request.setTemplateType(template.getTemplateType()); request.setTemplateName(template.getTemplateName()); request.setTemplateContent(template.getTemplateContent()); request.setRemark(template.getRemark()); AddSmsTemplateResponse res = client.addSmsTemplate(request); if (Objects.equals(TeamConstants.NEWS_SUCCESS_CODE, res.body.getCode())) { log.info("======申请短信模板，返回值：{}", JSON.toJSON(res.body)); return MessageVo.builder() .code(Constants.NEWS_SUCCESS_CODE) .message(Constants.NEWS_SUCCESS_MESSAGE) .templateCode(res.getBody().templateCode) .build(); return MessageVo.builder().code(Constants.NEWS_FAIL_CODE).message(Constants.NEWS_FAIL_MESSAGE).build(); log.error("======申请短信模板，异常：{}", e.getMessage()); * @MonthName： deleteSmsTemplate * @Description： 删除短信模板 public MessageVo deleteSmsTemplate(SmsTemplateDto template) { log.info("======删除短信模板，请求参数：{}", JSON.toJSON(template)); DeleteSmsTemplateRequest request = new DeleteSmsTemplateRequest(); request.setTemplateCode(template.getTemplateCode()); DeleteSmsTemplateResponse res = client.deleteSmsTemplate(request); log.info("======删除短信模板，返回值：{}", JSON.toJSON(res.body)); return MessageVo.builder().code(Constants.NEWS_SUCCESS_CODE).message(Constants.NEWS_SUCCESS_MESSAGE).build(); log.error("======删除短信模板，异常：{}", e); * @MonthName： modifySmsTemplate * @Description： 修改未通过审核的短信模板 public MessageVo modifySmsTemplate(SmsTemplateDto template) { log.info("======修改未通过审核的短信模板，请求参数：{}", JSON.toJSON(template)); ModifySmsTemplateRequest request = new ModifySmsTemplateRequest(); ModifySmsTemplateResponse res = client.modifySmsTemplate(request); log.info("======修改未通过审核的短信模板，返回值：{}", JSON.toJSON(res.body)); log.error("======修改未通过审核的短信模板，异常：{}", e.getMessage()); * @MonthName： querySmsTemplate * @Description： 查询短信模板的审核状态 public MessageVo querySmsTemplate(SmsTemplateDto template) { log.info("======查询短信模板的审核状态，请求参数：{}", JSON.toJSON(template)); QuerySmsTemplateRequest request = new QuerySmsTemplateRequest(); QuerySmsTemplateResponse res = client.querySmsTemplate(request); log.info("======查询短信模板的审核状态，返回值：{}", JSON.toJSON(res.body)); log.error("======查询短信模板的审核状态，异常：{}", e.getMessage());}2.3、SmsConfig.java
package com.tanersci.config;import lombok.Data;import org.springframework.beans.factory.annotation.Value;import org.springframework.boot.context.properties.ConfigurationProperties;import org.springframework.context.annotation.Configuration;import org.springframework.stereotype.Component;/** * @ClassName： SmsConfig.java * @ClassPath： com.tanersci.config.SmsConfig.java * @Description： 短信配置 * @Author： tanyp * @Date： 2021/6/7 16:41 **/@Data@Componentpublic class SmsConfig { @Value("${sms.access-id}") private String accessId; @Value("${sms.access-key}") private String accessKey; @Value("${sms.sign-name}") private String signName; @Value("${sms.endpoint}") private String endpoint;}2.4、VO、DTO类
MessageVo 同用邮件的
MailMessageDto.java
package com.tanersci.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.io.Serializable;/** * @ClassName： MailMessageDto.java * @ClassPath： com.tanersci.dto.SmsMessageDto.java * @Description： 短信 * @Author： tanyp * @Date： 2021/6/7 9:20 **/@Data@AllArgsConstructor@NoArgsConstructor@Builder@ApiModel(value = "短信消息")public class SmsMessageDto implements Serializable { private static final long serialVersionUID = 3427970548460798908L; @ApiModelProperty(value = "手机号，多个以逗号隔开") private String phone; @ApiModelProperty(value = "模板编码") private String templateCode; @ApiModelProperty(value = "模板参数") private TemplateParamDto param; private String code;}SmsTemplate.java
package com.tanersci.dto;import lombok.AllArgsConstructor;import lombok.Builder;import lombok.Data;import lombok.NoArgsConstructor;import java.io.Serializable;/** * @ClassName： SmsTemplate.java * @ClassPath： com.tanersci.dto.SmsTemplateDto.java * @Description： 短信模板 * @Author： tanyp * @Date： 2021/6/7 15:02 **/@Data@AllArgsConstructor@NoArgsConstructor@Builderpublic class SmsTemplateDto implements Serializable { private static final long serialVersionUID = -8909531614461840038L; /** * 模板类型：0：验证码，1：短信通知，2：推广短信，3：国际/港澳台消息。 */ private Integer templateType; * 模板名称，长度为1~30个字符 private String templateName; * 模板内容，长度为1~500个字符 private String templateContent; * 短信模板CODE private String templateCode; * 短信模板申请说明。请在申请说明中描述您的业务使用场景，长度为1~100个字符 private String remark;}注意
项目中使用lombok插件和swagger依赖，无相关依赖的请自行修改。
读到这里，这篇"SpringBoot集成短信和邮件的配置方法"文章已经介绍完毕，想要掌握这篇文章的知识点还需要大家自己动手实践使用过才能领会，如果想了解更多相关内容的文章，欢迎关注行业资讯频道。
短信
邮件
模板
参数
配置
服务
多个
状态
服务器
消息
邮箱
附件
图片
地址
逗号
口号
编码
查询
普通
图片资源
数据库的安全要保护哪些东西
数据库安全各自的含义是什么
生产安全数据库录入
数据库的安全性及管理
数据库安全策略包含哪些
海淀数据库安全审计系统
建立农村房屋安全信息数据库
易用的数据库客户端支持安全管理
连接数据库失败ssl安全错误
数据库的锁怎样保障安全
数据库mdf文件能删吗
网络安全的信息技术应用
文件服务器的定义和功能
崇明区参考数据库销售服务电话
下列属于云数据库产品的是
无线通信网络技术论文
博物馆网络安全教育总结
重庆金童盛世互联网科技有限公司
软件开发去哪儿学
scala操作npp数据库
哈利波特抢先服务器多长时间
玉溪网络技术服务
linux服务器搭建sk5
天门软件开发企业
松江区一站式软件开发价格咨询
pg数据库修改归档文件路径
北京计算机软件开发学校
ea服务器为什么不能登录
信息网络安全法律法规宣传标语
信息网络安全知识多选题
swiss数据库怎么筛选ob值
我的世服务器界坐标指令
散列值数据库应用
db2查询数据库表个数
缅甸高防服务器
数据库最小关系怎么看
杭州原谷网络技术有限公司
软件开发技术来源怎么写
部队网络安全个人自查范文
朝阳区网络技术服务热线
