Springboot项目中使用手机号短信验证码注册登录实现

本文将介绍如何在Spring Boot应用中实现短信验证码注册和登录功能，为用户提供便捷的移动端认证体验。

1. 功能概述

我们将实现以下功能：

• 手机号+验证码注册
• 手机号+验证码登录

2. 技术栈

• Spring Boot 3.2.0
• 互亿无线短信平台
• MyBatis Flex
• JWT

---

原文链接：https://blog.ybyq.wang/archives/647.html

3. 实现步骤

3.1 短信服务集成

首先，需要在application.properties中配置短信平台信息：

# 短信配置
sms.account=C09251523
sms.apikey=826efdf7322e3c49355428a523c10eec

3.2 创建短信工具类

创建SmsUtil工具类处理短信发送：

@Component
public class SmsUtil {private static final Logger logger = LoggerFactory.getLogger(SmsUtil.class);// 短信发送API地址private static final String SMS_API_URL = "http://106.ihuyi.com/webservice/sms.php?method=Submit";// API账号和密码@Value("${sms.account:C09***523}")private String account;@Value("${sms.apikey:826efdf7322e3c49355***a523c10eec}")private String apiKey;/*** 发送短信验证码* @param phone 手机号* @param code 验证码* @return 发送结果，包含code和msg*/public Map<String, String> sendVerificationCode(String phone, String code) {Map<String, String> result = new HashMap<>();try {// 短信内容String content = "您的验证码是：" + code + "。请不要把验证码泄露给其他人。";// 发送请求String response = sendSmsRequest(phone, content);// 解析结果result = parseXmlResponse(response);// 记录日志if ("2".equals(result.get("code"))) {logger.info("短信发送成功，手机号: {}, 验证码: {}", phone, code);} else {logger.error("短信发送失败，手机号: {}, 错误信息: {}", phone, result.get("msg"));}} catch (Exception e) {logger.error("发送短信验证码异常", e);result.put("code", "0");result.put("msg", "系统异常，短信发送失败");}return result;}// 省略发送请求和解析响应的方法...
}

3.3 验证码生成和存储

在UserServiceImpl中实现验证码管理：

// 在UserServiceImpl中
private final Map<String, String> smsCodeCache = new HashMap<>();@Override
public boolean sendSmsCode(String phone, String type) {try {// 校验手机号格式if (!isValidPhoneNumber(phone)) {return false;}// 生成6位随机验证码String code = generateRandomCode(6);// 将验证码存入缓存，实际项目中应使用Redis等缓存服务smsCodeCache.put(phone + ":" + type, code);// 发送短信Map<String, String> result = smsUtil.sendVerificationCode(phone, code);// 检查发送结果return "2".equals(result.get("code"));} catch (Exception e) {logger.error("发送短信验证码失败", e);return false;}
}@Override
public String getSmsCode(String phone, String type) {return smsCodeCache.get(phone + ":" + type);
}@Override
public void removeSmsCode(String phone, String type) {smsCodeCache.remove(phone + ":" + type);
}

3.4 控制器实现

发送短信验证码

@PostMapping("/send/sms")
public ResponseEntity<?> sendSmsCode(@RequestParam @NotBlank @Pattern(regexp = "^1[3-9]\\d{9}$", message =