微信小程序获取手机验证码短信验证码后端功能实现解析

Dear 丶 2023-10-06 08:29 60阅读 0赞

**本文原创首发CSDN，链接 [https://mp.csdn.net/console/editor/html/106041472][https_mp.csdn.net_console_editor_html_106041472] ，作者博客[https://blog.csdn.net/qq\_41464123][https_blog.csdn.net_qq_41464123] ，转载请带上本段内容，尤其是脚本之家、码神岛等平台，谢谢配合。**

--------------------

**目录**

前言

第一步： a) 创建短信签名、创建短信正文模板

b)短信签名

c)短信模板

第二步：使用Java SDK调用短信发送API接口

--------------------

> 在之前的小程序项目中，争对用户信息的有效性问题（比如手机号是否真实），我使用了微信小程序自带的获取手机号的功能，获取到用户的手机号，因为微信绑定的手机号一定经过微信的严格验证，能够确保手机号真实。但是根据客户的需求，需要实现使用短信验证码登入的功能，那么没办法，客户是上帝，我只能去实现它。

## 前言 ##

对于获取微信绑定的手机号来确保小程序用户的真实性，[可以看我这篇文章][Link 1]，我写的很详细。

接下来讲解如何实现短信验证码来校验用户的有效性。

本文主要讲解实现微信小程序获取手机短信验证码的后端部分，希望能帮到大家

--------------------

**实现过程如下**

1.  腾讯云中创建短信签名、创建短信正文模板，人工审核
2.  使用Java SDK调用短信发送API接口
3.  短信发送成功

**（因为客户要求使用腾讯云服务器，所以我这里用腾讯云为例）**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70][]

## 第一步：创建短信签名、创建短信正文模板 ##

首先理解一下相关概念：

#### **短信签名** ####

> 短信签名是位于短信正文前【】中的署名，用于标识公司或业务，例如【腾讯科技】。申请时企业用户需要上传资质证明，个人用户需要上传个人身份证明。短信签名需要审核通过后才可使用。  
> **签名示例：**  
> 认证企业为：深圳市腾讯计算机系统有限公司，可以申请与企业名相关的签名`【腾讯科技】`，也可以申请公司旗下的产品名称相关的签名`【微信】`、`【腾讯云】`等。

简而言之，如果短信内容为：

【腾讯科技】您的QQ登录验证码是1234，5分钟内有效。

那么，**短信签名**就是——**腾讯科技**。这样看懂了吧？

--------------------

#### 短信模板 ####

> 短信模板即具体发送的短信正文内容，短信模板支持验证码模板、通知类短信模板和营销短信模板。短信内容可以通过模板参数实现个性化定制。

如果短信内容为：

腾讯科技需要发送短信验证码：【腾讯科技】您的QQ登录验证码是1234，2分钟内有效。

那么，**短信模板**就是：`您的QQ登录验证码是{1}，{2}分钟内有效。`  
模板参数中\{1\}，\{2\}是变量，且按序排列，他们的值可以在实际下发时通过设置模板参数的值来自定义。

--------------------

为了避免开发者滥发短信，所以短信签名、短信模板需要腾讯云进行人工审核，具体操作如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 1][]

打开[腾讯云官网][Link 2]，进入右上角控制台，进入短信界面，然后创建签名。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 2][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 3][]

然后同样的方法，创建短信模板

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 4][]

接着就是人工审核，大概10分钟左右就够了。

--------------------

## 第二步：使用Java SDK调用短信发送API接口 ##

所谓使用SDK，也就是说，腾讯已经给你写好发送短信的API接口，连调用API接口的模板都给你写好了，你只要拿来用就可以。

SDK下载地址（Github）：[https://github.com/TencentCloud/tencentcloud-sdk-java][https_github.com_TencentCloud_tencentcloud-sdk-java]

当然这个SDK里面所有功能都实现了，比如发送短信，群发短信，拉取回执状态，统计短信发送数据，包括国内的，境外的，全都有。但是功能多，导包的时间也长，而我们只需要发送国内短信即可，所以我自己把他精简了一下，因为我这里只需要发送短信的功能。

**我这里以IDEA为例，打开IDEA，新建一个MAVEN项目**

**勾上Create from archetype**

**选择org.apache.maven.archetypes:maven-archetype-webapp**

**添加属性**

**name：archetypeCatalog，value：internal**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 5][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 6][]

**为什么要这么做？是因为系统默认从Maven获取依赖，但是很慢，我们可以选择从本地导入，这样基本不需要时间，达到快速创建项目的效果。**

--------------------

**创建完Maven项目，只需要修改两个文件**

1.pom.xml

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>org.example</groupId>
        <artifactId>yanzhengma</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
            <java.version>11</java.version>
            <maven.compiler.source>11</maven.compiler.source>
            <maven.compiler.target>11</maven.compiler.target>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>com.github.qcloudsms</groupId>
                <artifactId>qcloudsms</artifactId>
                <version>1.0.6</version>
            </dependency>
        </dependencies>
    </project>

2.随意包下的Main函数

import com.github.qcloudsms.SmsSingleSender;
    import com.github.qcloudsms.SmsSingleSenderResult;
    import com.github.qcloudsms.httpclient.HTTPException;
    import org.json.JSONException;
    import java.io.IOException;
    public class Main {
        public static void main(String[] args) {
            // 短信应用 SDK AppID
            int appid = 1400xxxx84; // SDK AppID 以1400开头
            // 短信应用 SDK AppKey
            String appkey = "d4e5bxxxxxxxxxx02c907501b4ee8645";
            // 需要发送短信的手机号码
            String[] phoneNumbers = {"178xxxxxx85"};
            // 短信模板 ID，需要在短信应用中申请
            int templateId = 60xxx8; // NOTE: 这里的模板 ID`7839`只是示例，真实的模板 ID 需要在短信控制台中申请
            // 签名
            String smsSign = "XXXX"; // NOTE: 签名参数使用的是`签名内容`，而不是`签名ID`。这里的签名"腾讯云"只是示例，真实的签名需要在短信控制台申请
            try {
                String[] params = {"5678","5"};
                SmsSingleSender ssender = new SmsSingleSender(appid, appkey);
                SmsSingleSenderResult result = ssender.sendWithParam("86", phoneNumbers[0],
                        templateId, params, smsSign, "", "");
                System.out.println(result);
            } catch (HTTPException e) {
                // HTTP 响应码错误
                e.printStackTrace();
            } catch (JSONException e) {
                // JSON 解析错误
                e.printStackTrace();
            } catch (IOException e) {
                // 网络 IO 错误
                e.printStackTrace();
            }
        }
    }

还有要这四个jar包

![20200510211044819.png][]

**我们就像Java运行Hello World那样，运行一下主函数，短信就发出来了**

--------------------

接下来来解析一下代码：

**1.短信账号，密匙**

int appid = 1400xxxx84;
    String appkey = "d4e5bxxxxxxxxxx02c907501b4ee8645";

类似微信小程序，**appid是账号，appkey是密匙**，我们在腾讯云控制台获取。

点进去可以查看appkey。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 7][]

--------------------

**2.需要发送的手机号**

String[] phoneNumbers = {"178xxxxxx85"};

**3.短信模板ID**

int templateId = 60xxx8;

在第一步的 国内短信 —— 签名管理 中 查看ID。

**4.签名**

String smsSign = "XXXX";

同短信模板，你申请的是什么签名，这里就写什么，比如“腾讯科技”

**5.填入参数**

String[] params = {"5678","5"};

在第一步中，介绍了短信模板的概念

**短信模板**就是：`您的QQ登录验证码是{1}，{2}分钟内有效。`

其中这个\{1\}，类似SQL中的预编译，这里有几个参数，这个params数组就几个元素。

短信发出去就是——`您的QQ登录验证码是5678，5分钟内有效。`

--------------------

**以上数据全部替换后，执行Main主函数就可以，短信就发出来了**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 8][]

**这就是微信小程序中，实现短信验证码登入的后端操作，时间有限，我只是简单写了一下，还有更多功能，我会在后续继续深入研究。**

[https_mp.csdn.net_console_editor_html_106041472]: https://mp.csdn.net/console/editor/html/106041472
[https_blog.csdn.net_qq_41464123]: https://blog.csdn.net/qq_41464123
[Link 1]: https://blog.csdn.net/qq_41464123/article/details/105214094
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200510204236398.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200510205713643.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[Link 2]: https://console.cloud.tencent.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200510205109646.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20200510205311241.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20200510205437390.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[https_github.com_TencentCloud_tencentcloud-sdk-java]: https://github.com/TencentCloud/tencentcloud-sdk-java
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20200510210624417.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20200510210727864.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[20200510211044819.png]: https://img-blog.csdnimg.cn/20200510211044819.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20200510211553225.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz_size_16_color_FFFFFF_t_70 8]: https://img-blog.csdnimg.cn/20200510212454702.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNDY0MTIz,size_16,color_FFFFFF,t_70