【Springboot中使用腾讯云实现发送短信验证码功能】

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

由于现在阿里云不能提供短信模块的个人测试签名和内容模板，在这里选用腾讯云的短信发送验证码的SDK

---

提示：以下是本篇文章正文内容，下面案例可供参考

一、腾讯云短信申请与使用

1.申请注册微信公众号
https://mp.weixin.qq.com/

2.选择订阅号 注册并实名认证

二、登录腾讯云官方网站

https://cloud.tencent.com/?fromSource=gwzcw.2212127.2212127.2212127&utm_medium=cpd&utm_id=gwzcw.2212127.2212127.2212127
（如果没有账户 需要注册登录）

1.搜索短信模块 进入

2.选择国内短信 签名管理

3.申请创建签名

4.创建正文模板

这里建议使用标准模板

申请结束 等待审核通过 一般十分钟左右就会通过

三.使用腾讯云实现短信发送功能

https://cloud.tencent.com/document/product/382/43193

根据使用的编程语言选择相关文档 （我这里使用的是java）

1.首先我们需要创建一个Springboot 基础工程 我这里使用的 IDEA

在pom文件中 引入 所需要的依赖

<dependency>
     <groupId>com.tencentcloudapi</groupId>
     <artifactId>tencentcloud-sdk-java</artifactId>
     <version>3.1.270</version><!-- 注：这里只是示例版本号（可直接使用），可获取并替换为 最新的版本号，注意不要使用4.0.x版本（非最新版本） -->
</dependency>

因为我这里使用到了 redis 来存储短信验证码 所以加上了redis的依赖
注意 ： 不要忘了 在配置文件中加入 redis的 host

  <!--redis 依赖包-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>

2.创建一个发送短信的工具类

public class TxSmsUtil {
public static boolean TXSms(String phone,String sdkAppId ,String templateId,String signName,String code) {
        try {

            Credential cred = new Credential("自己的SecretId", "自己的SecretKey");
            // 实例化一个http选项，可选，没有特殊需求可以跳过
            HttpProfile httpProfile = new HttpProfile();
            // 设置代理（无需要直接忽略）
            // httpProfile.setProxyHost("真实代理ip");
            // httpProfile.setProxyPort(真实代理端口);
            /* SDK默认使用POST方法。
             * 如果你一定要使用GET方法，可以在这里设置。GET方法无法处理一些较大的请求 */
            httpProfile.setReqMethod("POST");
            /* SDK有默认的超时时间，非必要请不要进行调整
             * 如有需要请在代码中查阅以获取最新的默认值 */
            httpProfile.setConnTimeout(60);
            /* 指定接入地域域名，默认就近地域接入域名为 sms.tencentcloudapi.com ，也支持指定地域域名访问，例如广州地域的域名为 sms.ap-guangzhou.tencentcloudapi.com */
            httpProfile.setEndpoint("sms.tencentcloudapi.com");
            /* 非必要步骤:
             * 实例化一个客户端配置对象，可以指定超时时间等配置 */
            ClientProfile clientProfile = new ClientProfile();
            /* SDK默认用TC3-HMAC-SHA256进行签名
             * 非必要请不要修改这个字段 */
            clientProfile.setSignMethod("HmacSHA256");
            clientProfile.setHttpProfile(httpProfile);
            /* 实例化要请求产品(以sms为例)的client对象
             * 第二个参数是地域信息，可以直接填写字符串ap-guangzhou，支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 */
            SmsClient client = new SmsClient(cred, "ap-guangzhou",clientProfile);
            /* 实例化一个请求对象，根据调用的接口和实际情况，可以进一步设置请求参数*/

            SendSmsRequest req = new SendSmsRequest();
            req.setSmsSdkAppId(sdkAppId);
            req.setSignName(signName);
            req.setTemplateId(templateId);
            String[] templateParamSet = {code};
            req.setTemplateParamSet(templateParamSet);
            /* 下发手机号码，采用 E.164 标准，+[国家或地区码][手机号]
             * 示例如：+8613711112222， 其中前面有一个+号 ，86为国家码，13711112222为手机号，最多不要超过200个手机号 */
            String[] phoneNumberSet = {phone};
            req.setPhoneNumberSet(phoneNumberSet);

            /* 用户的 session 内容（无需要可忽略）: 可以携带用户侧 ID 等上下文信息，server 会原样返回 */
            String sessionContext = "";
            req.setSessionContext(sessionContext);

            /* 通过 client 对象调用 SendSms 方法发起请求。注意请求方法名与请求对象是对应的
             * 返回的 res 是一个 SendSmsResponse 类的实例，与请求对象对应 */
            SendSmsResponse res = client.SendSms(req);

            // 输出json格式的字符串回包
            System.out.println(SendSmsResponse.toJsonString(res));

            // 也可以取出单个值，你可以通过官网接口文档或跳转到response对象的定义处查看返回字段的定义
            // System.out.println(res.getRequestId());
        } catch (TencentCloudSDKException e) {
            e.printStackTrace();
        }
        return false;
    }

    

}

3.模拟实际业务通过redis来存储验证码 并且设置过期时间

编写 Service 和 实现类 

public interface TxSms {

    public boolean send (String phone);
    
}

public class TxSmsImpl implements TxSms {

    @Autowired
    private RedisTemplate<String,String> redisTemplate;

    @Override
    public boolean send(String phone) {

        //生成验证码 
        String code = UUID.randomUUID().toString().substring(0,4);
        //调用工具类发送验证码到手机
        boolean res = TxSmsUtil.TXSms("+86" + phone,"sdkAppId","templateId","signName",code);
        System.out.println("-------------"+res);
        if (!res){
            //发送成功后将验证码放到Redis中设置存活时间1分钟
            redisTemplate.opsForValue().set(phone,code,1, TimeUnit.MINUTES);
            return true;

        }else {
            return false;
        }


    }
}

4 .Controller类

@RestController
@CrossOrigin //跨域支持
public class SmsApiController {

    @Autowired
    private RedisTemplate<String,String> redisTemplate;

    @Autowired
    private TxSms txSms;

    @GetMapping("/test/{phone}")
    public String code2(@PathVariable("phone")String phone){

        //调用发送方法 （模拟业务 redis）
        //首先去redis中查该规定时间内手机号有没有生成验证码
        String code = redisTemplate.opsForValue().get(phone);
        System.out.println("redis中的验证码----------"+code);
        if (!StringUtils.isEmpty(code)){
            return phone +" :" +"验证码已存在，请稍后重试";
        }
        //若Redis中没有，调用service发送短信方法
        boolean res = txSms.send(phone);
        System.out.println(res);
        if (res){
            return phone + " : "+"发送成功";

        }else {
            return phone + " : "+"发送失败";
        }
    }
}