10分钟搞定！SpringBoot集成腾讯云短信全攻略，从配置到发送一气呵成

<dependency>
       <groupId>com.tencentcloudapi</groupId>
       <artifactId>tencentcloud-sdk-java</artifactId>
       <version>3.1.XXX</version> <!-- 请替换为最新版本 -->
       <scope>compile</scope>
   </dependency>

tencent:
     sms:
       secret-id: your-secret-id # 替换为你的SecretId
       secret-key: your-secret-key # 替换为你的SecretKey
       sdk-app-id: 1400000000 # 替换为你的SDKAppID
       sign-name: 你的签名内容 # 替换为审核通过的签名内容
       template-id: 1234567 # 替换为你常用的默认模板ID

import lombok.Data;
   import org.springframework.boot.context.properties.ConfigurationProperties;
   import org.springframework.context.annotation.Configuration;
   
   @Configuration
   @ConfigurationProperties(prefix = "tencent.sms")
   @Data
   public class TencentSmsProperties {
       private String secretId;
       private String secretKey;
       private String sdkAppId;
       private String signName;
       private String templateId;
   }

import com.tencentcloudapi.common.Credential;
   import com.tencentcloudapi.common.exception.TencentCloudSDKException;
   import com.tencentcloudapi.common.profile.ClientProfile;
   import com.tencentcloudapi.common.profile.HttpProfile;
   import com.tencentcloudapi.sms.v20210111.SmsClient;
   import com.tencentcloudapi.sms.v20210111.models.*;
   import lombok.RequiredArgsConstructor;
   import lombok.extern.slf4j.Slf4j;
   import org.springframework.stereotype.Service;
   
   @Service
   @Slf4j
   @RequiredArgsConstructor
   public class TencentSmsService {
   
       private final TencentSmsProperties smsProperties;
   
       /**
        * 发送短信验证码
        *
        * @param phoneNumber 目标手机号（带区号，如"+8613712345678"）
        * @param templateId  模板ID（可选，不填则使用配置的默认模板ID）
        * @param templateParams 模板参数列表，按顺序替换模板中的变量{citation:6}
        * @return 发送是否成功
        */
       public boolean sendSms(String phoneNumber, String templateId, String[] templateParams) {
           try {
               // 1. 实例化认证对象，传入SecretId和SecretKey[citation:10]
               Credential cred = new Credential(smsProperties.getSecretId(), smsProperties.getSecretKey());
   
               // 2. 配置HTTP和客户端Profile
               HttpProfile httpProfile = new HttpProfile();
               httpProfile.setEndpoint("sms.tencentcloudapi.com"); // 短信API端点
               ClientProfile clientProfile = new ClientProfile();
               clientProfile.setHttpProfile(httpProfile);
   
               // 3. 实例化SmsClient
               SmsClient client = new SmsClient(cred, "ap-guangzhou", clientProfile); // 地域根据控制台指引选择
   
               // 4. 构造请求对象并填充参数
               SendSmsRequest req = new SendSmsRequest();
               req.setSmsSdkAppId(smsProperties.getSdkAppId()); // 设置应用ID[citation:2]
               req.setSignName(smsProperties.getSignName()); // 设置签名[citation:2]
               req.setTemplateId(templateId != null ? templateId : smsProperties.getTemplateId()); // 设置模板ID
               req.setPhoneNumberSet(new String[]{phoneNumber}); // 设置手机号，支持批量
               req.setTemplateParamSet(templateParams); // 设置模板参数
   
               // 5. 发起请求并处理响应
               SendSmsResponse resp = client.SendSms(req);
               SendStatus status = resp.getSendStatusSet()[0]; // 取第一个号码的发送状态
               log.info("短信发送请求ID：{}，状态：{}，状态码：{}", resp.getRequestId(), status.getMessage(), status.getCode());
   
               // 6. 判断发送结果（通常以"Ok"表示成功，请根据实际响应判断）
               return "Ok".equalsIgnoreCase(status.getCode());
   
           } catch (TencentCloudSDKException e) {
               log.error("腾讯云短信SDK调用失败，错误信息：{}", e.toString(), e);
               return false;
           }
       }
   
       /**
        * 简化方法：发送固定模板的短信（如验证码）
        *
        * @param phoneNumber 目标手机号
        * @param code        验证码
        * @return 发送是否成功
        */
       public boolean sendVerificationCode(String phoneNumber, String code) {
           // 假设你的验证码模板内容为：您的验证码是{1}，有效期{2}分钟。
           String[] templateParams = {code, "5"}; // 验证码和有效期
           return sendSms(phoneNumber, null, templateParams); // 使用配置中的默认模板ID
       }
   }

import lombok.RequiredArgsConstructor;
   import org.springframework.web.bind.annotation.*;
   
   @RestController
   @RequestMapping("/api/sms")
   @RequiredArgsConstructor
   public class SmsController {
   
       private final TencentSmsService smsService;
   
       @PostMapping("/send-code")
       public ApiResponse sendVerificationCode(@RequestParam String phoneNumber) {
           // 1. 生成随机验证码（示例）
           String code = String.valueOf((int)((Math.random() * 9 + 1) * 100000));
   
           // 2. 发送短信
           boolean isSuccess = smsService.sendVerificationCode(phoneNumber, code);
   
           // 3. 此处应将验证码与手机号关联存储到Redis或Session，并设置过期时间，用于后续校验[citation:6]
           // redisTemplate.opsForValue().set("SMS_CODE:" + phoneNumber, code, 5, TimeUnit.MINUTES);
   
           if (isSuccess) {
               return ApiResponse.success("短信发送成功");
           } else {
               return ApiResponse.fail("短信发送失败，请稍后重试");
           }
       }
   
       // 简单的响应封装类
       @Data
       public static class ApiResponse {
           private boolean success;
           private String message;
           private Object data;
   
           public static ApiResponse success(String message) {
               ApiResponse response = new ApiResponse();
               response.setSuccess(true);
               response.setMessage(message);
               return response;
           }
   
           public static ApiResponse fail(String message) {
               ApiResponse response = new ApiResponse();
               response.setSuccess(false);
               response.setMessage(message);
               return response;
           }
       }
   }