QQ邮箱发送验证码(Springboot)

一、邮箱发送服务准备

在qq邮箱的设置中选择账号下开启服务。

开启时可能会有短信验证，开启后显示验证码之类的一串英文，复制保存起来，在配置文件中会使用到。

二、后端依赖及配置

依赖

在pom.yml文件中添加相关依赖，redis的相关依赖需要根据项目的版本进行选择相符的（下面依赖的项目版本为2.7.6）

<!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-mail  邮箱依赖--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-mail</artifactId></dependency>
<!-- redis --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId></dependency><dependency><groupId>org.springframework.session</groupId><artifactId>spring-session-data-redis</artifactId></dependency><dependency><groupId>org.redisson</groupId><artifactId>redisson</artifactId><version>3.17.5</version></dependency>

配置文件

  #发送邮箱验证码mail:#发送者邮箱username: **********@qq.com(自己的邮箱)#申请到的授权码password: *******(开启服务时的英文)# 配置 SMTP 服务器地址host: smtp.qq.com#端口号465或587port: 465protocol: smtps# 默认的邮件编码为UTF-8default-encoding: UTF-8# 配置SSL 加密工厂properties:mail:smtp:socketFactoryClass: javax.net.ssl.SSLSocketFactory#表示开启 DEBUG 模式，这样，邮件发送过程的日志会在控制台打印出来，方便排查错误debug: truessl: true

三、实现步骤

邮箱工具类

/*** 邮箱工具类* @author zero* @date 2025-06-05 17:26*/
@Component
public class MailUtils {@Resourceprivate JavaMailSenderImpl mailSender;@Resourceprivate RedisTemplate<String, String> redisTemplate;@Value("${spring.mail.username}") String sendEmail;/*** 发送信息* @param email 邮箱* @return 是否发送信息成功*/public boolean sendMail(String email) throws MessagingException {MimeMessage mimeMessage = mailSender.createMimeMessage();//生成随机验证码String code = generateCode(6);MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);//设置一个html邮件信息helper.setText("<p style='color: blue'>欢迎来到错题收集刷题系统！你的验证码为：" + code + "(有效期为一分钟)</p>", true);//设置邮件主题名helper.setSubject("注册验证码----验证码");//发给谁-》邮箱地址helper.setTo(email);//谁发的-》发送人邮箱helper.setFrom(sendEmail);//将邮箱验证码以邮件地址为key存入redis,1分钟过期redisTemplate.opsForValue().set(email, code, Duration.ofMinutes(1));mailSender.send(mimeMessage);return true;}/*** 生成指定长度的验证码* @param length 长度* @return 指定长度的验证码*/public static String generateCode(int length) {return UUID.randomUUID().toString().substring(0, length);}
}

 Controller层

/*** 获取注册验证码** @param email 邮箱* @return 验证码信息*/
@PostMapping("/sendEmail")
public BaseResponse<String> sendMailTest(@RequestParam String email) throws MessagingException {if (email == null) {throw new BusinessException(ErrorCode.PARAMS_EMPTY_ERROR, "邮箱为空");}String code = redisTemplate.opsForValue().get(email);if (!StringUtils.isEmpty(code)) {throw new BusinessException(ErrorCode.PARAMS_ERROR, "email + \":\" + code + \"已存在，还未过期\"");}boolean b = mailUtils.sendMail(email);if (b) {return ResultUtils.success("验证码发送成功！");}throw new BusinessException(ErrorCode.SEND_EMAIL_ERROR, "发送验证码失败！");
}