无缝集成指南，SpringBoot三步接入华为云短信服务

<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-smsapi</artifactId>
    <!-- 请前往华为云官网SDK中心查询并使用最新版本 -->
    <version>{latest-version}</version>
</dependency>

huaweicloud:
  sms:
    ak: your-access-key # 替换为你的AK
    sk: your-secret-key # 替换为你的SK
    project-id: your-project-id # 在“我的凭证-项目列表”中查找
    sender: 10690xxxxxxxx # 通道号，在创建的应用详情中查看
    signature: 华为云测试 # 已审核通过的签名名称
    template-id: xxxxxxxx # 已审核通过的模板ID
    region: cn-north-4 # 短信服务区域，如华北-北京四

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import lombok.Data;
​
@Component
@ConfigurationProperties(prefix = "huaweicloud.sms")
@Data
public class SmsConfig {
    private String ak;
    private String sk;
    private String projectId;
    private String sender;
    private String signature;
    private String templateId;
    private String region;
}

import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.sms.v2.SmsClient;
import com.huaweicloud.sdk.sms.v2.model.*;
import com.huaweicloud.sdk.sms.v2.region.SmsRegion;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.Arrays;
import java.util.List;
​
@Service
public class HuaweiSmsService {
​
    @Autowired
    private SmsConfig smsConfig;
​
    public Boolean sendSingleMessage(String mobile, List<String> templateParams) {
        // 1. 构建认证信息
        BasicCredentials auth = new BasicCredentials()
                .withAk(smsConfig.getAk())
                .withSk(smsConfig.getSk())
                .withProjectId(smsConfig.getProjectId());
​
        // 2. 初始化客户端 (注意Region枚举可能随SDK版本变化)
        SmsClient client = SmsClient.newBuilder()
                .withCredential(auth)
                .withRegion(SmsRegion.valueOf(smsConfig.getRegion().toUpperCase().replace("-", "_")))
                .build();
​
        // 3. 构造发送请求
        SendSmsRequest request = new SendSmsRequest()
                .withFrom(smsConfig.getSender()) // 发送号码（通道号）
                .withTo(Arrays.asList(mobile)) // 接收方号码列表
                .withTemplateId(smsConfig.getTemplateId()) // 模板ID
                .withTemplateParas(templateParams) // 模板变量值列表
                .withSignature(smsConfig.getSignature()); // 签名名称
​
        // 4. 发送请求并处理响应
        try {
            SendSmsResponse response = client.sendSms(request);
            // 根据SDK版本，成功判断可能是 response.getHttpStatusCode() == 200 或解析body中的code
            System.out.println("Request ID: " + response.getRequestId());
            return true;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }
}

@RestController
@RequestMapping("/api/sms")
public class SmsController {
    @Autowired
    private HuaweiSmsService smsService;
​
    @PostMapping("/send-verification")
    public String sendVerificationCode(@RequestParam String phone) {
        // 生成随机验证码
        String code = String.valueOf((int)((Math.random() * 9 + 1) * 100000));
        // 组装模板参数，顺序需与模板中变量定义一致
        List<String> params = Arrays.asList(code, "5");
​
        boolean isSuccess = smsService.sendSingleMessage(phone, params);
        if(isSuccess) {
            return "短信发送成功，验证码：" + code; // 生产环境不应返回验证码
        } else {
            return "短信发送失败";
        }
    }
}