springboot——集成阿里短信服务

最新推荐文章于 2025-05-31 16:29:49 发布

原创最新推荐文章于 2025-05-31 16:29:49 发布 · 339 阅读

0 ·

CC 4.0 BY-SA版权

springboot 专栏收录该内容

16 篇文章

订阅专栏

本文详细介绍如何使用Java调用阿里云短信服务，包括快速入门步骤、Maven依赖配置、核心Java代码实现及缓存机制，助您快速上手短信验证功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、快速入门

1、注册账号；
2、进入短信服务，点击新手引导；

3、申请国内短信签名和申请国内短信模版；
4、点击AccessKey创建AccessKey;

5、点击OpenAPI Explorer进入，选择“SendSms”
在这里插入图片描述

二、pom.xml配置

<dependencies>
	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter</artifactId>
	</dependency>
	<dependency>
		<groupId>org.projectlombok</groupId>
		<artifactId>lombok</artifactId>
		<optional>true</optional>
	</dependency>
	<dependency>
		<groupId>com.aliyun</groupId>
		<artifactId>aliyun-java-sdk-core</artifactId>
		<version>4.1.0</version>
	</dependency>
	<dependency>
		<groupId>com.google.guava</groupId>
		<artifactId>guava</artifactId>
		<version>28.1-jre</version>
	</dependency>
	<dependency>
		<groupId>org.apache.commons</groupId>
		<artifactId>commons-lang3</artifactId>
		<version>3.4</version>
	</dependency>
</dependencies>

三、Java代码

import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
import com.google.common.cache.CacheBuilder;
import com.google.common.cache.CacheLoader;
import com.google.common.cache.LoadingCache;
import com.google.gson.Gson;
import org.apache.commons.lang3.RandomStringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;

import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;

/**
 * 短信服务
 */
@Service
public class SMSManagerImpl implements SMSManager {
    private static final Logger logger = LoggerFactory.getLogger(SMSManagerImpl.class);

    @Value("${aliyun.message.accessKeyId}")
    private String accessKeyId;
    @Value("${aliyun.message.accessKeySecret}")
    private String accessKeySecret;
    @Value("${aliyun.message.signName}")
    private String signName;

    @Override
    public boolean sendSmsRegisterCode(String phoneNumber){
        String code = getRandomCode();
        boolean success = false;
        try {
            success = isSuccess(sendSms(phoneNumber, "SMS_170800227", code));
            if (success) {
                numberCodeMapping.put(phoneNumber, Optional.of(code));
            }
        } catch (ClientException e) {
            logger.error("发送短信异常：", e);
        }
        return success;
    }

    @Override
    public boolean validateRegisterCode(String phoneNumber, String code) {
        Optional<String> optional = getValue(phoneNumber);
        return optional.filter(s -> Objects.equals(code, s)).isPresent();
    }

    /**
     * 判断是否成功
     *
     * @param response
     * @return
     */
    private boolean isSuccess(CommonResponse response) {
        boolean success = response.getHttpStatus() == 200;
        if (!success) {
            logger.error("短信发送失败：" + response.getData());
        } else {
            Map map = new Gson().fromJson(response.getData(), Map.class);
            success = Objects.equals("OK", map.get("Code"));
        }
        return success;
    }

    private IAcsClient getClient() {
        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
        return new DefaultAcsClient(profile);
    }

    /**
     * 发送短信验证码
     *
     * @param phoneNumber
     * @param templateCode
     * @param code
     * @return
     */
    private CommonResponse sendSms(String phoneNumber, String templateCode, String code) throws ClientException {
        CommonRequest request = new CommonRequest();
        request.setMethod(MethodType.POST);
        request.setDomain("dysmsapi.aliyuncs.com");
        request.setVersion("2017-05-25");
        request.setAction("SendSms");
        request.putQueryParameter("RegionId", "cn-hangzhou");
        request.putQueryParameter("PhoneNumbers", phoneNumber);
        request.putQueryParameter("SignName", signName);
        request.putQueryParameter("TemplateCode", templateCode);
        request.putQueryParameter("TemplateParam", "{\"code\":\"" + code + "\"}");
        return getClient().getCommonResponse(request);
    }

    //============================================
    // 验证码缓存
    //============================================
    // 手机号<->验证码映射
    private LoadingCache<String, Optional<String>> numberCodeMapping = CacheBuilder.newBuilder()
            .concurrencyLevel(50).expireAfterAccess(15, TimeUnit.MINUTES)
            .build(new CacheLoader<String, Optional<String>>() {
                @Override
                public Optional<String> load(String key) throws Exception {
                    return Optional.empty();
                }
            });
    /**
     * 获取随机码
     *
     * @return
     */
    private String getRandomCode() {
        return RandomStringUtils.randomNumeric(6);
    }

    private Optional<String> getValue(String key) {
        try {
            return numberCodeMapping.get(key);
        } catch (ExecutionException e) {
            logger.error("获取缓存出错：", e);
        }
        return Optional.empty();
    }
}