<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java</artifactId>
    <version>3.1.XXX</version> <!-- 請?zhí)鎿Q為最新版本 -->
    <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: 你的簽名內(nèi)容 # 替換為審核通過的簽名內(nèi)容
    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;

    /**
     * 發(fā)送短信驗證碼
     *
     * @param phoneNumber 目標(biāo)手機號（帶區(qū)號，如"+8613712345678"）
     * @param templateId  模板ID（可選，不填則使用配置的默認模板ID）
     * @param templateParams 模板參數(shù)列表，按順序替換模板中的變量{citation:6}
     * @return 發(fā)送是否成功
     */
    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); // 地域根據(jù)控制臺指引選擇

            // 4. 構(gòu)造請求對象并填充參數(shù)
            SendSmsRequest req = new SendSmsRequest();
            req.setSmsSdkAppId(smsProperties.getSdkAppId()); // 設(shè)置應(yīng)用ID[citation:2]
            req.setSignName(smsProperties.getSignName()); // 設(shè)置簽名[citation:2]
            req.setTemplateId(templateId != null ? templateId : smsProperties.getTemplateId()); // 設(shè)置模板ID
            req.setPhoneNumberSet(new String[]{phoneNumber}); // 設(shè)置手機號，支持批量
            req.setTemplateParamSet(templateParams); // 設(shè)置模板參數(shù)

            // 5. 發(fā)起請求并處理響應(yīng)
            SendSmsResponse resp = client.SendSms(req);
            SendStatus status = resp.getSendStatusSet()[0]; // 取第一個號碼的發(fā)送狀態(tài)
            log.info("短信發(fā)送請求ID：{}，狀態(tài)：{}，狀態(tài)碼：{}", resp.getRequestId(), status.getMessage(), status.getCode());

            // 6. 判斷發(fā)送結(jié)果（通常以"Ok"表示成功，請根據(jù)實際響應(yīng)判斷）
            return "Ok".equalsIgnoreCase(status.getCode());

        } catch (TencentCloudSDKException e) {
            log.error("騰訊云短信SDK調(diào)用失敗，錯誤信息：{}", e.toString(), e);
            return false;
        }
    }

    /**
     * 簡化方法：發(fā)送固定模板的短信（如驗證碼）
     *
     * @param phoneNumber 目標(biāo)手機號
     * @param code        驗證碼
     * @return 發(fā)送是否成功
     */
    public boolean sendVerificationCode(String phoneNumber, String code) {
        // 假設(shè)你的驗證碼模板內(nèi)容為：您的驗證碼是{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. 發(fā)送短信
        boolean isSuccess = smsService.sendVerificationCode(phoneNumber, code);

        // 3. 此處應(yīng)將驗證碼與手機號關(guān)聯(lián)存儲到Redis或Session，并設(shè)置過期時間，用于后續(xù)校驗[citation:6]
        // redisTemplate.opsForValue().set("SMS_CODE:" + phoneNumber, code, 5, TimeUnit.MINUTES);

        if (isSuccess) {
            return ApiResponse.success("短信發(fā)送成功");
        } else {
            return ApiResponse.fail("短信發(fā)送失敗，請稍后重試");
        }
    }

    // 簡單的響應(yīng)封裝類
    @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;
        }
    }
}