安装阿里云短信认证服务 .NET SDK 2.0
命令安装
dotnet add package AlibabaCloud.SDK.Dypnsapi20170525 --version 2.0.0
图形化安装
从官网将调试代码复制到项目, 并编译运行
提示缺少默认凭证
打开官方给的链接进行凭证设置: https://help.aliyun.com/zh/sdk/developer-reference/v2-manage-net-access-credentials#2147ed304b2vl
此处选择使用配置文件设置凭证
看到以下运行结果即为运行成功, 可以注意查看手机是否接收到验证码
附加 AI 的模块化改造建议:
恭喜你成功跑通了 Demo。在将这个 Demo 封装为后端服务器使用的生产级模块时，我们需要考虑代码解耦、配置管理、异常处理、资源复用以及安全性。
我不改动你的源代码，而是建议你采用 “服务层（Service Layer）” 的模式进行封装。
1. 结构化封装建议
建议将 SDK 封装为一个独立的 SmsService，并通过依赖注入（DI）管理配置。
A. 配置模型类 (SmsConfig.cs)
不要在代码里硬编码 SchemeName 或 TemplateCode。
public class AliyunSmsOptions {public string Endpoint { get; set; } = "dypnsapi.aliyuncs.com";public string SchemeName { get; set; }public string SignName { get; set; }public string TemplateCode { get; set; }
}
B. 服务接口 (ISmsService.cs)
定义业务需要的行为，而不是 SDK 的原始行为。
public interface ISmsService {/// <summary>/// 发送验证码/// </summary>/// <param name="phoneNumber">手机号</param>/// <returns>返回发送状态或验证码(根据业务需求)</returns>Task<SendResult> SendVerifyCodeAsync(string phoneNumber);
}
C. 服务实现 (SmsService.cs)
将你的 CreateClient 和 SendSmsVerifyCode 逻辑整合。
public class AliyunSmsService : ISmsService {private readonly AlibabaCloud.SDK.Dypnsapi20170525.Client _client;private readonly AliyunSmsOptions _options;public AliyunSmsService(AliyunSmsOptions options) {_options = options;// 复用 Credential 逻辑，Client 应该作为单例或生命周期托管，避免频繁创建Aliyun.Credentials.Client credential = new Aliyun.Credentials.Client();var config = new AlibabaCloud.OpenApiClient.Models.Config { Credential = credential };config.Endpoint = _options.Endpoint;_client = new AlibabaCloud.SDK.Dypnsapi20170525.Client(config);}public async Task<SendResult> SendVerifyCodeAsync(string phoneNumber) {var request = new AlibabaCloud.SDK.Dypnsapi20170525.Models.SendSmsVerifyCodeRequest {SchemeName = _options.SchemeName,PhoneNumber = phoneNumber,SignName = _options.SignName,TemplateCode = _options.TemplateCode,// 业务参数动态化TemplateParam = "{\"code\":\"##code##\",\"min\":\"5\"}",CodeLength = 4,ValidTime = 300,ReturnVerifyCode = true};try {var response = await _client.SendSmsVerifyCodeWithOptionsAsync(request, new AlibabaCloud.TeaUtil.Models.RuntimeOptions());if (response.Body.Code == "OK") {return SendResult.Success(response.Body.VerifyCode);}return SendResult.Fail(response.Body.Message);}catch (Exception ex) {// 统一错误日志处理return SendResult.Fail(ex.Message);}}
}
2. 关键优化点
-
异步化 (Async/Await):
在后端服务器（尤其是 ASP.NET Core）中，务必使用Async结尾的方法（如SendSmsVerifyCodeWithOptionsAsync），以防止高并发时阻塞线程池。 -
生命周期管理:
AlibabaCloud.SDK.Dypnsapi20170525.Client内部持有连接池，不要每次调用接口都重建 Client。建议在 DI 容器中将其注册为 Singleton (单例)。 -
安全性加强:
- Credential 隔离: 继续使用你现在的
config.json方式是正确的，它实现了密钥与代码的分离。在生产环境，可以通过环境变量设置密钥路径。 - 立即更换密钥: 再次提醒，你在上一个问题中暴露了 Secret，请务必立即在阿里云后台作废原密钥并启用新密钥。
- Credential 隔离: 继续使用你现在的
-
业务逻辑解耦:
Demo 中的TemplateParam包含##code##，这是阿里云自动填充验证码的占位符。在封装时，可以将CodeLength和ValidTime放入配置文件，方便根据运营需求调整。 -
异常诊断:
保留error.Data["Recommend"]的获取。当发送失败时，将这个诊断 URL 记录到你的服务器日志中（NLog/Serilog），这会极大缩短线上问题的排查时间。
后端调用示例 (ASP.NET Core):
在 Program.cs 注册后，你可以在 Controller 中直接使用：
[ApiController]
[Route("api/auth")]
public class AuthController : ControllerBase {private readonly ISmsService _smsService;public AuthController(ISmsService smsService) {_smsService = smsService;}[HttpPost("send-code")]public async Task<IActionResult> SendCode(string phone) {var result = await _smsService.SendVerifyCodeAsync(phone);return result.IsSuccess ? Ok() : BadRequest(result.Message);}
}
这样封装后，你的业务代码会非常干净，且易于测试和维护。