让你的Demo更安全--Spring Boot实现短信验证码-Toy模板网

这篇具有很好参考价值的文章主要介绍了让你的Demo更安全--Spring Boot实现短信验证码。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

随着移动互联网的普及，短信验证码已经成为了很多应用的常用登录和注册方式之一。在传统的应用中，我们一般使用第三方集成商提供的短信验证码服务来实现短信验证码的发送和验证，但是这些服务有可能存在时间限制、价格过高等限制。

为了解决这些问题，我们可以使用Spring Boot来自己实现短信验证码。在本文中，我将向大家介绍如何使用Spring Boot来实现短信验证码，并提供详细的开发流程和代码示例。

前置条件

在实现短信验证码之前，需要配置以下环境和依赖：

JDK 1.8或以上版本
Maven 3.5或以上版本
Spring Boot 2.0或以上版本
阿里云短信服务

短信验证码的实现思路

在实现短信验证码之前，我们需要确定实现短信验证码需要哪些步骤：

客户端向服务端发送手机号码
服务端生成随机的验证码并发送到该手机号码
客户端将验证码发送到服务端进行校验

根据这个思路，我们可以通过以下几个步骤来实现短信验证码：

在application.properties文件中配置阿里云短信服务的AccessKey和SecretKey：

# 阿里云短信服务的AccessKey
aliyun.sms.accessKeyId=your_accessKeyId
# 阿里云短信服务的SecretKey
aliyun.sms.accessKeySecret=your_accessKeySecret

定义短信验证码的请求和响应类：

public class SmsRequest {
    // 手机号码
    private String phone;
    // 验证码
    private String code;
    // 发送时间
    private Long timestamp;
    // 签名
    private String signature;
    // getter和setter方法
}

public class SmsResponse {
    // 发送状态码
    private String code;
    // 发送消息
    private String message;
    // getter和setter方法
}

定义短信发送接口：

public interface SmsService {
    /**
     * 发送短信验证码
     *
     * @param phone 手机号码
     * @return 发送状态
     */
    SmsResponse sendSms(String phone);
}

实现短信发送接口：

@Service
public class SmsServiceImpl implements SmsService {
    // 阿里云短信服务的AccessKey
    @Value("${aliyun.sms.accessKeyId}")
    private String ACCESS_KEY_ID;
    // 阿里云短信服务的SecretKey
    @Value("${aliyun.sms.accessKeySecret}")
    private String ACCESS_KEY_SECRET;
    // 验证码的有效时间，单位为秒
    private static final int EXPIRATION = 120;

    /**
     * 发送短信验证码
     *
     * @param phone 手机号码
     * @return 发送状态
     */
    @Override
    public SmsResponse sendSms(String phone) {
        SmsResponse response = new SmsResponse();
        try {
            DefaultProfile profile = DefaultProfile.getProfile("default", ACCESS_KEY_ID, ACCESS_KEY_SECRET);
            IAcsClient client = new DefaultAcsClient(profile);

            SendSmsRequest request = new SendSmsRequest();

            // 设置短信模板
            request.setTemplateCode("SMS_123456789");

            // 生成验证码
            String code = String.valueOf((int)((Math.random()*9+1)*100000));

            // 将验证码保存到Redis缓存中
            jedis.setex(phone, EXPIRATION, code);

            Map<String, String> map = new HashMap<>(1);
            map.put("code", code);

            // 设置短信参数
            request.setTemplateParam(new Gson().toJson(map));

            request.setPhoneNumbers(phone);

            // 发送
            SendSmsResponse smsResponse = client.getAcsResponse(request);

            if (smsResponse.getCode() != null && smsResponse.getCode().equals("OK")) {
                response.setCode("200");
                response.setMessage("验证码发送成功");
            } else {
                response.setCode("500");
                response.setMessage("验证码发送失败，请稍后再试");
            }
        } catch (Exception e) {
            response.setCode("500");
            response.setMessage("验证码发送失败，请稍后再试");
            e.printStackTrace();
        }
        return response;
    }
}

在上述示例代码中，我们使用阿里云短信服务的SDK发送短信，首先从配置文件中获取AccessKey和SecretKey，然后生成IAcsClient对象，并设置模板代码，生成验证码并保存到Redis缓存中，最后发送短信。

创建接口Controller：

@RestController
@RequestMapping("/api/sms")
public class SmsController {

    private final SmsService smsService;

    public SmsController(SmsService smsService) {
        this.smsService = smsService;
    }

    /**
     * 发送短信验证码
     * @param phone 手机号码
     * @return 发送状态
     */
    @GetMapping("/send")
    public SmsResponse sendSms(@RequestParam("phone") String phone) {
        return smsService.sendSms(phone);
    }
}

在上面代码中，我们创建了一个发送短信验证码的接口，并使用@GetMapping注解将其映射到/api/sms/send路径上。

实现验证码校验：

@RestController
@RequestMapping("/api/sms")
public class SmsController {

    private final SmsService smsService;

    public SmsController(SmsService smsService) {
        this.smsService = smsService;
    }

    /**
     * 发送短信验证码
     * @param phone 手机号码
     * @return 发送状态
     */
    @GetMapping("/send")
    public SmsResponse sendSms(@RequestParam("phone") String phone) {
        return smsService.sendSms(phone);
    }

    /**
     * 校验验证码
     * @param request 校验请求
     * @return 校验结果
     */
    @PostMapping("/verify")
    public ResponseEntity<?> verifySms(@RequestBody SmsRequest request) {
        String code = jedis.get(request.getPhone());
        if (code != null && code.equals(request.getCode())) {
            jedis.del(request.getPhone());
            return ResponseEntity.ok("验证码校验成功");
        } else {
            return ResponseEntity.status(HttpStatus.FORBIDDEN).body("验证码校验失败");
        }
    }
}

在上述代码中，我们创建了一个校验短信验证码的接口，并使用@PostMapping注解将其映射到/api/sms/verify路径上。在接口实现中，我们从Redis缓存中获取验证码，若验证码有效，则从Redis缓存中删除验证码并返回成功响应，否则返回失败响应。

使用Redis缓存：

@Configuration
public class RedisConfig {

    @Value("${spring.redis.host}")
    private String host;

    @Value("${spring.redis.port}")
    private int port;

    @Bean
    JedisConnectionFactory jedisConnectionFactory() {
        RedisStandaloneConfiguration redisStandaloneConfiguration = new RedisStandaloneConfiguration(host, port);
        return new JedisConnectionFactory(redisStandaloneConfiguration);
    }

    @Bean
    RedisTemplate<String, Object> redisTemplate() {
        final RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(jedisConnectionFactory());
        template.setValueSerializer(new GenericToStringSerializer<>(Object.class));
        return template;
    }
}

在上述代码中，我们创建了一个Redis配置类，并使用@Configuration注解将其标注为配置类。在jedisConnectionFactory方法中，我们设置了Redis服务器的IP和端口，并返回一个JedisConnectionFactory对象，用于获取Jedis实例。在redisTemplate方法中，我们创建了一个RedisTemplate对象，并设置了序列化器和连接工厂。

至此，我们已经完成了短信验证码的实现。