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

Java集成【邮箱验证找回密码】功能

ds 2025/7/5 20:10:35

1.添加依赖

2.选择一个自己的邮箱，作为发件人角色。

3.编写邮箱配置【配置发件人邮箱】

4.编写邮箱配置类

5.编写controller业务代码

6.演示效果

7.总结流程

8.注意

结语

1.添加依赖

<!--导入邮箱依赖-->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-mail</artifactId><version>3.1.5</version>
</dependency>

2.选择一个自己的邮箱，作为发件人角色。

说白了，用户找回密码时，需要发件人发送给用户邮箱一个验证码，那么这个发件人邮箱，需要我们自己选取。

此时我就选择用我自己的QQ邮箱，作为发件人。

下面就需要我们去QQ邮箱，开启POP3/SMTP服务，获取授权码。

3.编写邮箱配置【配置发件人邮箱】

我们在【2】中，选取了我们自己的QQ邮箱，充当发件人角色。

那么我们此时，就需要将该QQ邮箱的配置信息（包含账号、授权码等等），配置到Java的application.yml文件中。

配置好以后，Java就可以在需要时，自动使用我们的QQ邮箱，给忘记密码的用户的邮箱发送验证码了。

4.编写邮箱配置类

其实【3】就够用了，但是有时候只完成3的配置，仍然无法注入JavaMailSender的实例。

@Configuration
public class MailConfig {@Beanpublic JavaMailSender javaMailSender() {JavaMailSenderImpl mailSender = new JavaMailSenderImpl();// 设置QQ邮箱SMTP服务器mailSender.setHost("smtp.qq.com");mailSender.setPort(587);  // QQ邮箱默认端口587（TLS）或465（SSL）// 设置邮箱账号和授权码（注意：password是授权码，不是QQ密码）mailSender.setUsername("发件邮箱账号");mailSender.setPassword("授权码");// 设置编码mailSender.setDefaultEncoding("UTF-8");// 设置SMTP协议属性Properties props = mailSender.getJavaMailProperties();props.put("mail.smtp.auth", "true");          // 启用认证props.put("mail.smtp.starttls.enable", "true"); // 启用TLS加密props.put("mail.smtp.starttls.required", "true"); // 必须使用TLSreturn mailSender;}
}

5.编写controller业务代码

由于发送邮件内容不多，所以我们就将所有代码都写到一个controller层即可，就不再创建service层了。

@RestController//表明这是一个controller层，并且自动将对象转为JSON格式返回
@RequestMapping("/api/email")//该controller的访问路径
public class SendEmailController {@Autowiredprivate JavaMailSender javaMailSender;@Autowiredprivate UserMapper userMapper;//发送邮件@PostMapping("/sendEmail")public Result sendEmail(@RequestBody EmailDto emailDto){//1.先查找数据库，是否存在该用户的账号，如果不存在，则返回错误信息“该账号不存在”User user = userMapper.queryUserByUsername(emailDto.getUsername());if(user == null){return new Result(404, "该账号不存在");}//2.如果该账号存在，则判断该邮箱是否绑定了该账号，如果没绑定，则返回错误信息“账号与邮箱未绑定”if(!user.getEmail().equals(emailDto.getEmail())){return new Result(404, "账号与邮箱未绑定");}//3.如果绑定了，则往该用户的邮箱中，发送一个验证码（多少位自己决定，一般是6位）//生成6位验证码Random random = new Random();int code = random.nextInt(900000) + 100000;//范围：100000-999999（6位随机数的范围）。SimpleMailMessage message = new SimpleMailMessage();message.setFrom("发件人邮箱");//设置发件人邮箱message.setTo(emailDto.getEmail());//设置收件人邮箱message.setSubject("东软HIS系统验证码");//邮件标题message.setText("邮箱验证码为：" + code + "，请勿发送给他人");//邮件内容try {javaMailSender.send(message);//4.将该验证码存入redis，有效时间设置为2分钟，以便后续验证该用户在前端输入的验证码是否正确。TODOreturn new Result(200, "发送成功");}catch (Exception e){throw new RuntimeException("发送邮箱验证码失败，请稍后再试");}}}

6.演示效果

情况1：账号不存在

情况2：账号与邮箱未绑定

情况3：账号与邮箱绑定。

可见此时我们的QQ小号的邮箱2037730735@qq.com也确实收到了这个邮箱验证码。

7.总结流程

①找一个自己的邮箱（QQ、163、outlook等都可以），作为发件人，并将该邮箱的信息配置到java后端

②收件人的邮箱，是从前端传递过来的（即：谁忘记了密码，谁就输入他自己的邮箱，作为验证码的收件人）。

③验证码发送成功后，应当存入redis，并设置有效时间（如：2分钟），以便用户在前端输入验证码后，验证正确性。