当前位置：首页 > news >正文

阿里云短信服务与ASP.NET对接实例

news 来源：原创 2025/6/21 14:16:25

准备工作

注册阿里云账号并开通阿里大于(现称"阿里云短信服务")服务
获取AccessKey ID和AccessKey Secret
申请短信签名和短信模板并审核通过

ASP.NET Web项目集成步骤

1. 安装阿里云SDK

通过NuGet包管理器安装阿里云短信服务SDK：

Install-Package Aliyun.Acs.Core
Install-Package Aliyun.Acs.Dysmsapi

2. 配置Web.config

在<appSettings>节点中添加阿里云配置：

<add key="AliyunSMS_AccessKeyId" value="您的AccessKeyId"/>
<add key="AliyunSMS_AccessKeySecret" value="您的AccessKeySecret"/>
<add key="AliyunSMS_SignName" value="您的短信签名"/>
<add key="AliyunSMS_TemplateCode" value="您的模板CODE"/>

写其他位置也可以。

3. 创建短信服务帮助类

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Dysmsapi.Model.V20170525;
using System;
using System.Web.Configuration;public class AliyunSMSHelper
{private static string accessKeyId = WebConfigurationManager.AppSettings["AliyunSMS_AccessKeyId"];private static string accessKeySecret = WebConfigurationManager.AppSettings["AliyunSMS_AccessKeySecret"];private static string signName = WebConfigurationManager.AppSettings["AliyunSMS_SignName"];private static string templateCode = WebConfigurationManager.AppSettings["AliyunSMS_TemplateCode"];public static SendSmsResponse SendSms(string phoneNumbers, string templateParam){// 设置超时时间System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;IClientProfile profile = DefaultProfile.GetProfile("cn-hangzhou", accessKeyId, accessKeySecret);DefaultProfile.AddEndpoint("cn-hangzhou", "cn-hangzhou", "Dysmsapi", "dysmsapi.aliyuncs.com");IAcsClient acsClient = new DefaultAcsClient(profile);SendSmsRequest request = new SendSmsRequest();try{// 必填:待发送手机号request.PhoneNumbers = phoneNumbers;// 必填:短信签名request.SignName = signName;// 必填:短信模板Coderequest.TemplateCode = templateCode;// 可选:模板中的变量替换JSON串request.TemplateParam = templateParam;SendSmsResponse response = acsClient.GetAcsResponse(request);return response;}catch (Exception ex){// 记录日志System.Diagnostics.Trace.WriteLine($"短信发送异常: {ex.Message}");return null;}}
}

4. 在控制器中使用短信服务

using System.Web.Mvc;public class SmsController : Controller
{public ActionResult SendVerificationCode(string phoneNumber){// 生成随机验证码string code = new Random().Next(1000, 9999).ToString();// 模板参数JSON (根据实际模板参数调整)string templateParam = $"{{\"code\":\"{code}\"}}";// 发送短信var response = AliyunSMSHelper.SendSms(phoneNumber, templateParam);if (response != null && response.Code == "OK"){// 发送成功，将验证码存入Session或数据库Session["VerificationCode"] = code;Session["VerificationPhone"] = phoneNumber;return Json(new { success = true, message = "验证码发送成功" });}else{string errorMsg = response?.Message ?? "短信服务异常";return Json(new { success = false, message = $"验证码发送失败: {errorMsg}" });}}public ActionResult VerifyCode(string phoneNumber, string code){if (Session["VerificationPhone"]?.ToString() == phoneNumber && Session["VerificationCode"]?.ToString() == code){// 验证成功return Json(new { success = true, message = "验证码正确" });}return Json(new { success = false, message = "验证码错误或已过期" });}
}

5. 前端调用示例 (jQuery)

// 发送验证码
$("#btnSendCode").click(function() {var phone = $("#phoneNumber").val();if (!phone) {alert("请输入手机号码");return;}$.post("/Sms/SendVerificationCode", { phoneNumber: phone }, function(data) {if (data.success) {alert("验证码已发送");// 开始倒计时countDown(60);} else {alert(data.message);}});
});// 验证验证码
$("#btnVerify").click(function() {var phone = $("#phoneNumber").val();var code = $("#verificationCode").val();$.post("/Sms/VerifyCode", { phoneNumber: phone, code: code }, function(data) {alert(data.message);if (data.success) {// 验证成功后的操作}});
});// 倒计时函数
function countDown(seconds) {var btn = $("#btnSendCode");btn.attr("disabled", true);var timer = setInterval(function() {btn.val(seconds + "秒后重新发送");seconds--;if (seconds <= 0) {clearInterval(timer);btn.val("获取验证码");btn.attr("disabled", false);}}, 1000);
}