Spring Boot实现邮箱验证码功能全解析

1. Spring Boot邮箱验证码功能实现全景解析

在用户注册、密码重置等关键业务场景中，邮箱验证是最基础的安全验证手段之一。作为Java开发者，我们经常需要在Spring Boot项目中快速集成这一功能。不同于简单的API调用，一个生产可用的邮箱验证系统需要考虑协议选择、安全防护、性能优化等多个维度。本方案基于SMTP协议实现，同时涵盖异常处理、防刷机制等实战细节，可直接用于企业级项目。

2. 技术选型与准备

2.1 环境依赖配置

在pom.xml中添加Spring Boot邮件starter依赖：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

同时建议添加验证码生成工具库：

xml复制<dependency>
    <groupId>com.github.axet</groupId>
    <artifactId>kaptcha</artifactId>
    <version>2.3.2</version>
</dependency>

2.2 邮件服务器配置

在application.yml中配置SMTP服务参数：

yaml复制spring:
  mail:
    host: smtp.163.com
    username: yourmail@163.com
    password: yourpassword
    protocol: smtp
    port: 465
    properties:
      mail:
        smtp:
          ssl:
            enable: true
          auth: true
          connectiontimeout: 5000
          timeout: 3000
          writetimeout: 5000

生产环境建议将密码存储在配置中心或环境变量中，不要直接硬编码在配置文件里

3. 核心实现逻辑

3.1 验证码生成服务

创建验证码服务类CaptchaService：

java复制@Service
public class CaptchaService {
    private final Map<String, String> captchaCache = new ConcurrentHashMap<>();
    
    public String generateCaptcha(String email) {
        String captcha = RandomStringUtils.randomNumeric(6);
        captchaCache.put(email, captcha);
        return captcha;
    }
    
    public boolean validateCaptcha(String email, String inputCaptcha) {
        String savedCaptcha = captchaCache.get(email);
        return savedCaptcha != null && savedCaptcha.equals(inputCaptcha);
    }
}

3.2 邮件发送服务

实现邮件发送工具类EmailService：

java复制@Service
public class EmailService {
    @Autowired
    private JavaMailSender mailSender;
    
    @Value("${spring.mail.username}")
    private String from;
    
    public void sendVerificationEmail(String to, String captcha) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(from);
        message.setTo(to