新版阿里云发送短信验证码详解

关与作者更多博客请访问云里云外开源社区

一、申请短信服务步骤

首先进入阿里云控制台，点击左侧产品与服务，找到短信服务。

第一次进入会有新手引导，这里主要介绍一下大致步骤和易错点

申请短信签名和模板

短信签名一般是企业或者组织名的简写，主要是告知收信人自己是谁。一般体现在短信的开头，用括号括住。

【Dresults】您的验证码：139267，您正进行身份验证，打死不告诉别人！

模板就是我要发送内容的模板，每条短信共有的部分，将变化的部分抽出作为变量，体现在代码中。注意，短信模板具有类型，且不同类型收费标准不同，这里就先介绍短信验证码

至于模板具体选择，可以自定义也可以使用常用模板库（完全免费的），切记模板要遵守一定的规范。

验证码模板只支持验证码作为变量；变量替换值<=6位数字或字母
不能发送营销/贷款/借款/中奖/抽奖类短信,不支持金融理财&房产通知类短信(验证码除外)
签名/模版申请规范 https://help.aliyun.com/document_detail/55324.html

最后是申请说明，这里大家简要介绍一下此模板的应用场景或者介绍一下自己或公司，一般没什么用。提交申请后2小时左右就会收到审批通知

订购短信套餐包

这步一般不需要什么操作，因为阿里云短信收费是预先缴费，按量付费。只要阿里云账号有钱就可以，不需要订购。

系统设置

这步还是要仔细看一下，主要是安全设置，有防盗刷机制，这里不详细展开，阿里云的文档还是很详细的。

发送短信

有两种方式，分别是API发送和群发助手进行短信群发。这里介绍API发送

查看开发者指南—不同编程语言的短信服务SDK（Software Development Kit 软件开发工具包）—JAVA SDK DEMO

按照图示箭头一次选择，这里取消只看必填参数，后面如果需要扩展再自行选择（必填参数中没有验证码参数）

这里的三个参数介绍一下，一开始是默认不填参数的，右侧的代码中也没有对于的参数，我们手动填写后，代码中才会出现参数。还有代码中的内容除了我们自己填写的，其他都不要修改,下面这个不是时间，是版本号，修改了就会出错，其他也一样。

request.setSysVersion("2017-05-25");

AccessKey ID和AccessKey Secret设置

鼠标放到用户头像处，点击下拉选项AccessKey管理，进入页面后，创建AccessKey。输入手机验证码后，就创建成功了。注意****这是唯一一次保存键和密码的时间，保存到本地上，以后就不可查看了，只能删除重建。

AccessKey ID和AccessKey Secret相当于是阿里云账号的一个子账号，起到验证作用，可以用这个账号来调用阿里云API服务。

第一个参数，PhoneNumber手机号，第二个SignName签名名称（必须审核通过的才行）；第三个TemplateCode短信模板ID（是模板管理的模板CODE）；第四个是短信验证码模板变量参数（这里用json格式{“code”:“123456”}，注意要用小写。验证码的值后面代码中用随机数替代，code按照自己模板中的写，一般是code）

最后可以尝试发起调用，这里测试不需要花钱。可以真实发送短信。

二、代码集成（java-SpringBoot）

public class MessageUtil {//产品名称:云通信短信API产品,开发者无需替换static final String product = "Dysmsapi";//产品域名,开发者无需替换static final String domain = "dysmsapi.aliyuncs.com";static final String accessKeyId = "填自己的";static final String accessKeySecret = "填自己的";@Autowiredprivate RedisRepository redisRepository;public MessageDto getSsm(String number) {if (number.equals("") || number == null) {throw new SysException("没有填写手机号");}System.setProperty("sun.net.client.defaultConnectTimeout", "10000");System.setProperty("sun.net.client.defaultReadTimeout", "10000");//初始化acsClient,暂不支持region化IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);try {DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);} catch (ClientException e1) {e1.printStackTrace();}IAcsClient acsClient = new DefaultAcsClient(profile);//随机生成六位验证码int code = (int) ((Math.random() * 9 + 1) * 100000);//组装请求对象-具体描述见控制台-文档部分内容SendSmsRequest request = new SendSmsRequest();//必填:待发送手机号request.setPhoneNumbers(number);//必填:短信签名-可在短信控制台中找到，你在签名管理里的内容request.setSignName("填自己的");//必填:短信模板-可在短信控制台中找到，你模板管理里的模板编号request.setTemplateCode("填自己的");//可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为request.setTemplateParam("{\"code\":\"" + code + "\"}");//选填-上行短信扩展码(无特殊需求用户请忽略此字段)//request.setSmsUpExtendCode("90997");//可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者//request.setOutId("yourOutId");//hint 此处可能会抛出异常，注意catchSendSmsResponse sendSmsResponse = null;try {sendSmsResponse = acsClient.getAcsResponse(request);} catch (ServerException e) {e.printStackTrace();} catch (ClientException e) {e.printStackTrace();}//获取发送状态MessageDto messageDto = new MessageDto(code, sendSmsResponse.getCode());//保存手机验证码至redis中，大家没有用的话可以保存在mysql数据库中redisRepository.saveMessageCode(number, String.valueOf(code));log.info(number + ":  发送了一条验证码");return messageDto;}}

三、验证码应用

这里介绍我对验证码的理解，验证码一般是用在登录或注册处的，为的就是防止机器暴力调用接口，造成资源的浪费。

具体流程是，先按下发送验证码的按钮，这时手机会收到短信。下一步就是我们最初的目的，或是登录或是注册，选项中有一项为输入验证码。输入后，后台会校验手机号和验证码是否对应。所以在发送验证码后，后台要将手机号和验证码的键值对保存起来。保存的地方可以是mysql，也可以是redis。

如果是redis，本身就具备了键值对的对应关系，只需要保存就好。

如果是Mysql，需要我们建表，并加上两列，分别是手机号和验证码。

这里介绍一下redis的代码部分

RedisUtil为工具类，直接接触redis

public class RedisUtil {public static boolean exists(StringRedisTemplate redisTemplate, String key) {return redisTemplate.hasKey(key);}public static<T> void set (StringRedisTemplate redisTemplate, String key, T  value) {redisTemplate.opsForValue().set(key, JsonUtil.toJson(value));}public static<T> T get (StringRedisTemplate redisTemplate, String key, Class<T> clazz) {String value = redisTemplate.opsForValue().get(key);if (null != value) {return JsonUtil.toObject(value, clazz);}return null;}public static void del(StringRedisTemplate redisTemplate, String key) {redisTemplate.delete(key);}
}

这个RedisRepository的实现类

里面有一处代码需要注意，RedisKeyTemplate.T_VERIFICATION_CODE，这个在最后的代码块中能发现，是给redis空间命名。相信聪明的大家肯定可以明白的。

RedisUtil.set(redisTemplate, RedisKeyUtil.buildKey(RedisKeyTemplate.T_VERIFICATION_CODE, phone), messageCode);

@Component
public class RedisRepositoryImpl implements RedisRepository {@Autowiredprivate StringRedisTemplate redisTemplate;/*** 保存手机号和验证码的键值对<phone, messageCode>** @param phone* @param messageCode 验证码*/@Overridepublic void saveMessageCode(String phone, String messageCode) {RedisUtil.set(redisTemplate, RedisKeyUtil.buildKey(RedisKeyTemplate.T_VERIFICATION_CODE, phone), messageCode);}@Overridepublic String selectMessageCodeByPhone(String phone) {return RedisUtil.<String>get(redisTemplate, RedisKeyUtil.buildKey(RedisKeyTemplate.T_VERIFICATION_CODE, phone), String.class);}
}

public interface RedisRepository {/*** 保存手机号和验证码的键值对<phone, messageCode>* @param phone* @param messageCode 验证码*/void saveMessageCode(String phone, String messageCode);/*** 根据key：手机号 查询验证码* @param phone* @return*/String selectMessageCodeByPhone(String phone);
}

public class RedisKeyTemplate {/***记录验证码信息* 键：Verification_Code:verificationCode* 值：{ verificationCode, phoneNumber }*/public final static String T_VERIFICATION_CODE = "Verification:%s";
}