sms4j 发送短信

news2025/4/11 7:31:39

一、使用介绍

技术介绍：
SMS4J: 短信 支持 阿里云 腾讯云 云片 等等各式各样的短信服务商
项目地址：

SMS4J: 让简单的事情回归简单的本质。 SMS4J为短信聚合框架，帮您轻松集成多家短信服务，解决接入多个短信SDK的繁琐流程。目前已接入数家常见的短信服务商，后续将会继续集成。后续的版本中我们还将推出更多的相关功能你的 ⭐️ ⭐️⭐️Star⭐️⭐️ ⭐️，是我的动力！如果你觉得还不错，请点上一颗小星星 (gitee.com)https://gitee.com/dromara/sms4j

sms4j 项目整合文档地址:

🐍简介 | SMS4J文档前言：本项目的开发和测试以及支持更多的运营厂商，均需要作者去掏钱买对应厂商的短信（在此批判那些起售一万条的厂商！）网站的域名以及服务器均需要大量的成本支出。 sms4j将持续免费的更新下去，如果你觉得这个项目对你有所帮助，还请放行网站广告，并为我们点一个star。如果方便，欢迎您对我们进行赞助或者捐助，您的支持将是我们前进的最大动力！参考demo ...https://sms4j.com/doc3

二、集成到项目

2.1 引入maven依赖

<dependency>
            <groupId>org.dromara.sms4j</groupId>
            <artifactId>sms4j-spring-boot-starter</artifactId>
             <version> version </version>
            <exclusions>
                <!-- 排除京东短信内存在的fastjson等待作者后续修复 -->
                <exclusion>
                    <groupId>com.alibaba</groupId>
                    <artifactId>fastjson</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

2.2 配置yml 短信厂商

厂商支持：

阿里云 --- alibaba
容联云 --- cloopen
天翼云 --- ctyun
亿美软通 --- emay
华为云短信 --- huawei京东云短信 --- jdcloud网易云信 --- netease
腾讯云短信 --- tencent
合一短信 --- unisms
云片短信 --- yunpian
助通短信 --- zhutong
鼎众短信 --- dingzhong
联麓短信 --- yunpian
七牛云短信 --- qiniu

厂商差异配置文档地址：

✨厂商配置 | SMS4J文档https://sms4j.com/doc3/supplierConfig.html

该处演示阿里和腾讯短信配置：

--- # sms 短信 支持 阿里云 腾讯云 云片 等等各式各样的短信服务商
# https://wind.kim/doc/start 文档地址 各个厂商可同时使用
sms:
  # 阿里云 dysmsapi.aliyuncs.com
  alibaba:
    #请求地址 默认为 dysmsapi.aliyuncs.com 如无特殊改变可以不用设置
    requestUrl: dysmsapi.aliyuncs.com
    #阿里云的accessKey
    accessKeyId: xxxxxxx
    #阿里云的accessKeySecret
    accessKeySecret: xxxxxxx
    #短信签名
    signature: 测试
  tencent:
    #请求地址默认为 sms.tencentcloudapi.com 如无特殊改变可不用设置
    requestUrl: sms.tencentcloudapi.com
    #腾讯云的accessKey
    accessKeyId: xxxxxxx
    #腾讯云的accessKeySecret
    accessKeySecret: xxxxxxx
    #短信签名
    signature: 测试
    #短信sdkAppId
    sdkAppId: appid
    #地域信息默认为 ap-guangzhou 如无特殊改变可不用设置
    territory: ap-guangzhou

三、阿里云配置

搜索短信服务：

配置发送模版：

创建accesskey用户，就能得到啊里云的accessKey 和阿里云的accessKeySecret。复制到上面yml配置中就行

注意：记得给账号授权

四、发送短信测试

测试调用阿里云短信：


@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/demo/sms")
public class SmsController {

    /**
     * 发送短信Aliyun
     *
     * @param phones     电话号
     * @param templateId 模板ID
     */
    @GetMapping("/sendAliyun")
    @SaIgnore
    public R<Object> sendAliyun(String phones, String templateId) {
        LinkedHashMap<String, String> map = new LinkedHashMap<>(1);
        map.put("code", "1234");
        SmsBlend smsBlend = SmsFactory.createSmsBlend(SupplierType.ALIBABA);
        SmsResponse smsResponse = smsBlend.sendMessage(phones, templateId, map);
        return R.ok(smsResponse);
    }

    /**
     * 发送短信Tencent
     *
     * @param phones     电话号
     * @param templateId 模板ID
     */
    @GetMapping("/sendTencent")
    public R<Object> sendTencent(String phones, String templateId) {
        LinkedHashMap<String, String> map = new LinkedHashMap<>(1);
//        map.put("2", "测试测试");
        map.put("1", "1234");
        SmsBlend smsBlend = SmsFactory.createSmsBlend(SupplierType.TENCENT);
        SmsResponse smsResponse = smsBlend.sendMessage(phones, templateId, map);
        return R.ok(smsResponse);
    }

}

调用参数：

phones：接受的手机号
templateId ：指的是模版code
发送路径：
GET http://localhost:8080/demo/sms/sendAliyun?phones=18761581366&templateId=SMS_305031111

收到短信

博主精心整理专栏，CV大法即可用，感谢您小手点一点手动跪拜：

1- SpringBoot框架常用配置（若依），代码解读：

http://t.csdnimg.cn/jpsSN

2- java常用工具类整理，示例演示：

http://t.csdnimg.cn/gmCfJ

3- CompletableFuture 异步编排与实际代码展示

http://t.csdnimg.cn/ZuC0N

4- XXL-JOB 详细学习，手把手带入门

http://t.csdnimg.cn/lyR7Y