2026年阿里云短信服务全攻略：从入门到精通的实战指南

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>dysmsapi20170525</artifactId>
  <!-- 请将 'the-latest-version' 替换为最新版本号：https://mvnrepository.com/artifact/com.aliyun/dysmsapi20170525 -->
  <version>the-latest-version</version>
</dependency>

# 阿里云key
aliyun:
  sms:
    accessKeyId: xxxxxxxxxxxxxxx
    accessSecret: xxxxxxxxxxxxxxxxxxxx
    endpoint: dysmsapi.aliyuncs.com
    signName: 签名

 
import com.aliyun.dysmsapi20170525.Client;
import com.aliyun.dysmsapi20170525.models.SendSmsRequest;
import com.aliyun.dysmsapi20170525.models.SendSmsResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
import com.b2bwings.nry.app.business.web.param.message.SmsSendParam;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
 
 
@Slf4j
@Component
@ConfigurationProperties(prefix = "aliyun.sms")
public class SmsUtil {
    // 访问密钥id
    @Value("${aliyun.sms.accessKeyId}")
    private String accessKeyId;
 
    // 访问密钥secret
    @Value("${aliyun.sms.accessSecret}")
    private String accessKeySecret;
 
    // 短信 API 的访问域名
    @Value("${aliyun.sms.endpoint}")
    private String endpoint;
 
    // 短信签名
    @Value("${aliyun.sms.signName}")
    private String signName;
 
    /**
     * 创建客户端
     */
    public Client createClient() {
        // 创建阿里云客户端：配置访问密钥 ID、 配置密钥、配置访问端点
        Config config = new Config()
                .setAccessKeyId(accessKeyId)
                .setAccessKeySecret(accessKeySecret);
        config.endpoint = endpoint;
        Client client = null;
        try {
            client = new Client(config);
        } catch (Exception e) {
            log.error("阿里云短信服务初始化失败:{}" ,e.getMessage());
        }
        return client;
    }
 
 
    // 发送短信
    public Boolean sendSms(SmsSendParam param) {
        // 阿里云客户端
        Client client = createClient();
        // 构建发送请求
        SendSmsRequest sendSmsRequest = new SendSmsRequest()
                // 设置签名
                .setSignName(signName)
                // 设置模板
                .setTemplateCode(param.getTemplateCode())
                // 设置手机号为参数传入的值
                .setPhoneNumbers(param.getPhone())
                // 设置模板为参数传入的值(map转json):{\"code\":\"" + code + "\"}
                .setTemplateParam(param.getTemplateParam());
 
        // 运行时选择，可以设置不同的属性来配置运行时环境的参数。
        RuntimeOptions runtime = new RuntimeOptions();
        try {
            SendSmsResponse sendSmsResponse = client.sendSmsWithOptions(sendSmsRequest, runtime);
            if (!"OK".equals(sendSmsResponse.getBody().getCode())) {
                log.info("短信发送失败:{}" ,sendSmsResponse.getBody().getMessage());
                return false;
            }
            log.info("短信发送成功");
            return true;
 
        } catch (Exception error) {
            log.info("短信发送异常:{}" , error.getMessage());
            return false;
        }
    }
}

import io.swagger.annotations.ApiModelProperty;
import lombok.AllArgsConstructor;
import lombok.Data;
 
/**
 * 发送短信参数
 * @author 
 */
@Data
@AllArgsConstructor
public class SmsSendParam {
 
    @ApiModelProperty(value = "发送目标手机号")
    private String phone;
 
    @ApiModelProperty(value = "模板Code")
    private String templateCode;
 
    @ApiModelProperty(value = "模板参数")
    private String templateParam;
}

//构建发送短信参数
            SmsSendParam sendParam = new SmsSendParam(phone, templateCode, JsonUtil.getJsonString(map));
            Boolean verifyCode = smsUtil.sendSms(sendParam);
            //发送失败
            if (!verifyCode) {
                //存储验证码值redis,保存短信记录
                putRedisHandle(templateCode, phone, code, msgLog, now, time);
 
                msgLog.setRequestStatus(2);
                msgLog.setGmtModified(now);
                msgLogMapper.updateById(msgLog);
 
                return ApiResult.fail(ApiCode.LOGIN_SMS_ERR);
            }else{
                putRedisHandle(templateCode, phone, code, msgLog, now, time);
            }
            return ApiResult.ok();