SpringBoot3集成SMS4J实现短信+OA双渠道消息发送

 更新时间:2026年04月05日 10:20:42   作者:码路星河  
本文主要介绍了SpringBoot3快速集成SMS4J,10分钟搞定短信+OA双渠道消息发送,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

做后端业务开发,短信发送是绕不开的基础功能,但直接对接各家云厂商短信SDK,不仅配置繁琐、业务耦合度高,换个服务商就要重构大半代码,纯纯费力不讨好。而且日常项目里,除了短信验证码,OA系统消息通知也是高频需求,单独对接OA接口又要额外写一套逻辑。最近用SpringBoot3做项目,直接上手了SMS4J这个开源工具,不仅适配SpringBoot3.x、一键切换多厂商短信,还能同步集成OA消息通知,一套工具搞定双渠道发送。

一、项目环境与核心依赖

先确认基础环境,我这边用的是SpringBoot 3.2.5、JDK17。

第一步先引入Maven核心依赖,直接在pom.xml中添加官方starter。

<!-- SMS4J SpringBoot3启动器 官方最新稳定版3.3.5 -->
<dependency>
    <groupId>org.dromara.sms4j</groupId>
    <artifactId>sms4j-spring-boot-starter</artifactId>
    <version>3.3.5</version>
</dependency>
<!-- SMS4J OA消息通知 -->
<dependency>
    <groupId>org.dromara.sms4j</groupId>
    <artifactId>sms4j-oa-core</artifactId>
    <version>3.3.5</version>
</dependency>

依赖引入后刷新Maven,等待下载完成即可,不用额外做依赖排除。

二、核心配置:短信+OA一体化配置

接下来是核心配置环节,不用写自定义配置类,直接在application.yml中同时配置短信和OA消息,一份配置文件管理双渠道,切换厂商和OA地址只改配置,业务代码零改动。我以阿里云短信+通用OA通知为例,配置逻辑清晰易懂。

提前准备好阿里云短信参数:AccessKey、Secret、短信签名、模板ID;OA相关参数:OA接口地址、应用密钥、审批人/接收人标识,都是后台可直接获取的基础参数。

spring:
  application:
    name: sms4j-demo
# SMS4J核心配置,3.3.5版本支持短信+OA双配置
sms:
  config-type: yaml
  blends:
    # 阿里云短信配置
    aliyun:
      supplier: alibaba
      accessKeyId: 您的阿里云AccessKey
      accessKeySecret: 您的阿里云Secret
      signature: 短信签名
      templateId: SMS_215125134
      templateName: code
      requestUrl: dysmsapi.aliyuncs.com
   oas:
     oaDingTalkByYaml: # configId
       isEnable: true # 表示该配置是否生效(默认生效,false表示不生效)
       supplier: ding_ding # 厂商标识
       tokenId: 您的accessKey # webhook 中的 access_token
       sign: 您的sign # 安全设置在验签模式下才的秘钥,非验签模式没有此值

不管是新增腾讯云、华为云短信,还是调整OA对接参数,都只需要在blends下新增或修改配置块,业务逻辑完全不用动,多渠道切换和扩展极其灵活,这也是SMS4J的核心优势。

三、代码实现:短信+OA双发送接口

配置完成后直接写业务代码,SMS4J通过工厂类统一管理渠道实例,短信和OA发送调用逻辑高度一致,代码极度简洁,适配登录验证码、业务审批通知等场景。

import cn.hutool.core.util.RandomUtil;
import org.dromara.oa.api.OaSender;
import org.dromara.oa.comm.entity.Request;
import org.dromara.oa.comm.entity.Response;
import org.dromara.oa.comm.enums.MessageType;
import org.dromara.oa.core.provider.factory.OaFactory;
import org.dromara.sms4j.api.SmsBlend;
import org.dromara.sms4j.api.entity.SmsResponse;
import org.dromara.sms4j.core.factory.SmsFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.ArrayList;
 
@RestController
@RequestMapping("/sms")
public class SmsController {
 
    /**
     * 通用短信验证码发送接口
     * @param phone 接收短信的手机号
     * @return 发送结果反馈
     */
    @GetMapping("/send/{phone}")
    public String sendSmsCode(@PathVariable String phone) {
        // 获取对应厂商标识的短信实例,和yml配置一一对应
        SmsBlend smsBlend = SmsFactory.getSmsBlend("aliyun");
        // 生成6位纯数字验证码,适配绝大多数验证码场景
        String code = RandomUtil.randomNumbers(6);
        // 执行短信发送,参数顺序严格匹配短信模板变量顺序
        SmsResponse response = smsBlend.sendMessage(phone, code);
        // 结果返回,开发阶段可直接返回验证码调试,生产环境建议隐藏
        if (response.isSuccess()) {
            return "短信发送成功,验证码:" + code;
        }
        return "短信发送失败,失败原因:" + response.getData().toString();
    }
 
    /**
     * 通用OA通知发送接口
     * @param phone 接收通知的手机号
     * @return 发送结果反馈
     */
    @GetMapping("/send/oa/notice/{phone}")
    public String sendOANotice(@PathVariable String phone) {
        String configId = "oaDingTalkByYaml";
        OaSender alarm = OaFactory.getSmsOaBlend(configId);
        Request request = new Request();
        ArrayList<String> phones = new ArrayList<>();
        phones.add(phone);
        // 支持通过手机号@
        request.setPhoneList(phones);
        // 支持@all
        // request.setIsNoticeAll(true);
        request.setContent("测试消息");
        Response response = alarm.sender(request, MessageType.DING_TALK_TEXT);
        // 结果返回
        if (response.isSuccess()) {
            return "OA通知消息发送成功";
        }
        return "OA通知消息发送失败,失败原因:" + response.getData().toString();
    }
}

注意:模板变量顺序要和配置、后台模板完全匹配,OA消息可根据内部需求调整模板内容,支持文本、审批提醒等多种格式,调用方式和短信完全一致,学习成本极低。

四、核心避坑提示

  • 参数一致性:短信和OA的密钥、地址、模板ID必须和后台完全一致,空格、字符错误会直接导致发送失败;
  • 渠道标识对应:SmsFactory获取实例的标识,必须和yml中blends下的配置名一一对应,不可写错;
  • 生产环境规范:敏感密钥切勿硬编码,建议放到Nacos、Apollo配置中心,OA内网地址做好权限管控;
  • 单渠道 fallback:可加判断逻辑,某一渠道失败时,另一渠道兜底,提升消息送达率。

五、总结

整体集成全程不到10分钟,依托SMS4J 3.3.5最新版本,SpringBoot3集成零兼容问题,不仅搞定了多厂商短信的解耦对接,还顺带实现了OA消息通知,一套框架管理双渠道消息,代码简洁、扩展灵活。不管是中小型项目的基础消息功能,还是需要多渠道灾备的业务场景,都能快速落地。

到此这篇关于SpringBoot3集成SMS4J实现短信+OA双渠道消息发送的文章就介绍到这了,更多相关SpringBoot3集成SMS4J双渠道消息发送内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • hadoop的hdfs文件操作实现上传文件到hdfs

    hadoop的hdfs文件操作实现上传文件到hdfs

    这篇文章主要介绍了使用hadoop的API对HDFS上的文件访问,其中包括上传文件到HDFS上、从HDFS上下载文件和删除HDFS上的文件,需要的朋友可以参考下
    2014-03-03
  • MyBatis-plus中的模糊查询解读

    MyBatis-plus中的模糊查询解读

    这篇文章主要介绍了MyBatis-plus中的模糊查询解读,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05
  • java实现斗地主游戏

    java实现斗地主游戏

    这篇文章主要为大家详细介绍了java实现斗地主游戏,洗牌、发牌、看牌,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-01-01
  • java实现图形化界面计算器

    java实现图形化界面计算器

    这篇文章主要为大家详细介绍了java实现图形化界面计算器,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-05-05
  • Java 通过手写分布式雪花SnowFlake生成ID方法详解

    Java 通过手写分布式雪花SnowFlake生成ID方法详解

    SnowFlake是twitter公司内部分布式项目采用的ID生成算法,开源后广受国内大厂的好评。由这种算法生成的ID,我们就叫做SnowFlakeID,下面我们来详细看看
    2022-04-04
  • Spring事务捕获异常后依旧回滚的解决

    Spring事务捕获异常后依旧回滚的解决

    本文主要介绍了Spring事务捕获异常后依旧回滚的解决,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-01-01
  • java -jar指定外部配置文件操作步骤

    java -jar指定外部配置文件操作步骤

    这篇文章主要给大家介绍了关于java -jar指定外部配置文件的相关资料,需要的朋友可以参考下
    2023-11-11
  • idea导入gradle项目时遇到的坑及解决

    idea导入gradle项目时遇到的坑及解决

    这篇文章主要介绍了idea导入gradle项目时遇到的坑及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-04-04
  • Spring加载加密的配置文件详解

    Spring加载加密的配置文件详解

    这篇文章主要为大家详细介绍了Spring加载加密的配置文件,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07
  • Spring+Http请求+HttpClient实现传参

    Spring+Http请求+HttpClient实现传参

    这篇文章主要介绍了Spring+Http请求+HttpClient实现传参,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-03-03

最新评论