java发送手机验证码实现

article/2025/8/27 22:06:59

正文

今天来用java实现手机验证码的发送。

短信平台有很多，中国网建提供的SMS短信通，注册免费5条短信，3条彩信，

http://sms.webchinese.cn/

但是刚才试了，第一次用官方提供的demo发送成功，然后整合到自己项目中，调试时由于参数配置错误导致发送了几次失败后，5次就用完了。按理说成功才能算一次，果断放弃。

然后试了一下腾讯云SMS平台，每月可以免费发送100条国内短信

https://cloud.tencent.com/product/sms

在这里插入图片描述

首先需要注册腾讯云账号，注册时可以微信认证，认证时支付1分钱验证是人为操作，这一分钱注册成功后会放到账户中。

在这里插入图片描述

注册后，需要添加一个应用，这个随便写，创建好后点击 -> 应用名称，然看AppID和AppKey，这个比较重要，调用短信API接口时需要提供。

在这里插入图片描述

然后需要在 -> 国内短信 -> 短信内容配置 -> 短信签名中创建签名和短信正文中创建正文模板。

在这里插入图片描述

一个完整的短信由短信签名和短信正文内容两部分组成，您可以根据业务需求分别设置不同的短信正文内容模板，然后进行组合形成最终展示。短信签名+短信正文内容=最终显示内容

审核可能得需要花一段时间，我创建后，审核只花了2小时不到。这些步骤做完之后，就可以根据官方提供的API接口发送短信了。

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

官方提供了java、python、c#、node.js的SDK，这里用java的SDK调用，这里有详细说明：

https://github.com/qcloudsms/qcloudsms_java

首先加入maven依赖：

<dependency><groupId>com.github.qcloudsms</groupId><artifactId>qcloudsms</artifactId><version>1.0.4</version>
</dependency>

编写调用SDK的代码：

/*** 腾讯云短信,100条一个月* 方法说明** @param phone* @return void* @Discription:扩展说明* @throws HTTPException  http status exception* @throws IOException    network problem*/public static void sendMsgByTxPlatform(String phone) throws Exception {// 短信应用SDK AppID// 1400开头int appId = 1402126548;// 短信应用SDK AppKeyString appKey = "b67d0bf7876c1d42121ca561953532";// 需要发送短信的手机号码// String[] phoneNumbers = {"15212111830"};// 短信模板ID，需要在短信应用中申请//NOTE: 这里的模板ID`7839`只是一个示例，真实的模板ID需要在短信控制台中申请int templateId = 148464;// 签名// NOTE: 这里的签名"腾讯云"只是一个示例，真实的签名需要在短信控制台中申请，另外签名参数使用的是`签名内容`，而不是`签名ID`String smsSign = "我的小碗汤";SmsSingleSender sSender = new SmsSingleSender(appId, appKey);//第一个参数0表示普通短信,1表示营销短信SmsSingleSenderResult result = sSender.send(0, "86",phone,RandomCodeUtils.getSixValidationCode() + "为您的登录验证码，请于" + 10 + "分钟内填写。如非本人操作，请忽略本短信。", "", "");if (result.result != 0) {throw new Exception("send phone validateCode is error" + result.errMsg);}}

参数说明：

@param type 短信类型，0 为普通短信，1 营销短信,需要和刚才页面上提交的短信正文下的类型一致
@param nationCode 国家码，如 86 为中国
@param phoneNumber 不带国家码的手机号
@param msg 信息内容，必须与申请的模板格式一致，否则将返回错误，{1}占位符可在代码中用实际需要发送的值替换
@param extend 扩展码，可填空
@param ext 服务端原样返回的参数，可填空