首页教程行业资讯正文

Java应用如何实现发送短信功能

uncle 行业资讯 2025年08月6日

0 收藏 0 点赞 734 浏览 4188 个字

摘要 :

文章目录 1 客户端/服务端两种模式 1、客户端模式 2、服务端模式 2 客户端模式 1、使用三方短信渠道 SDK 2、封装多个三方渠道接口 3 服务端模式 1、应用管理 2、精……

文
章
目
录

1 客户端/服务端两种模式

1、客户端模式
2、服务端模式

2 客户端模式

1、使用三方短信渠道 SDK
2、封装多个三方渠道接口

3 服务端模式

1、应用管理
2、精简的 SDK 提供按照模版单发/群发的功能
3、签名、模版管理
4、多渠道适配

总结

在Java应用中发送短信是一个常见的需求，尤其在需要验证用户身份、发送告警、营销推广或节日祝福等场景下。以下是一些业内常用的方法，帮助你优雅地在Java应用中发送短信。

1 客户端/服务端两种模式

Java 应用中发送短信通常需要使用短信服务提供商提供的短信 API 。

我们经常使用的短信渠道有：阿里云、腾讯云、华为云、亿美等。

发送短信模式分为两种：

1、客户端模式

客户端模式是指应用系统直接调用短信服务提供商提供的短信 API 发送短信。

2、服务端模式

服务端模式是独立创建一个短信平台服务，应用系统直接使用短信平台服务提供的 SDK 发送短信。

核心流程如下：

前端调用应用服务接口发送短信 ;
应用服务收到短信请求后，调用 SDK 方法根据模版发送短信
短信平台服务收到请求，根据路由算法选择配置的渠道（比如阿里云、腾讯云）发送短信；
短信成功发送到用户手机。

2 客户端模式

1、使用三方短信渠道 SDK

客户端模式是非常简单的模式，很多短信服务提供商会提供成熟的 SDK ，业务系统只需要添加 SDK 依赖以及相关配置，就可以调用 SDK 提供的方法发送短信。

我们以阿里云短信服务为例，调用 API 发送短信的全流程如下所示：

使用 SDK 示例如下：

@Slf4j
@Service
public class SmsServiceImpl implements ISmsService {

    @Override
    public void send(String mobile, String templateParam) {

        try {
            //使用工具类发送手机短信
            SmsResponseResult result = SmsRemoteApi.sendSms(mobile, templateParam);
            log.info(\"阿里云短信发送SDK调用成功：{}\", result);
            //ALIYUN_RESPONSE_FAIL(-501, \"阿里云响应失败\"),
            Assert.isTrue(result.getStatusCode() == 200, ResponseEnum.ALIYUN_RESPONSE_FAIL);
            //ALIYUN_SMS_LIMIT_CONTROL_ERROR(-502, \"短信发送过于频繁\"),//业务限流
            Assert.notEquals(\"isv.BUSINESS_LIMIT_CONTROL\", result.getBody().get(\"code\").toString(), ResponseEnum.ALIYUN_SMS_LIMIT_CONTROL_ERROR);
            //ALIYUN_SMS_ERROR(-503, \"短信发送失败\"),//其他失败
            Assert.equals(\"OK\", result.getBody().get(\"code\").toString(), ResponseEnum.ALIYUN_SMS_ERROR);

        } catch (ServerException e) {
            log.error(\"阿里云短信发送SDK调用失败：\" + ExceptionUtils.getStackTrace(e));
            throw new BusinessException(ResponseEnum.ALIYUN_SMS_ERROR, e);
        } catch (ClientException e) {
            log.error(\"阿里云短信发送SDK调用失败：\" + ExceptionUtils.getStackTrace(e));
            throw new BusinessException(ResponseEnum.ALIYUN_SMS_ERROR, e);
        } catch (Exception e) {
            log.error(\"短信发送失败：\" + ExceptionUtils.getStackTrace(e));
            throw new BusinessException(ResponseEnum.ALIYUN_SMS_ERROR, e);
        }
    }
}

国内云厂商阿里云、腾讯云、华为云的短信服务，都需要依次申请签名，申请模版，审核通过之后才能发送短信。

2、封装多个三方渠道接口

虽然使用三方短信渠道 SDK 非常简单，但是在实际项目中，可能会存在多个三方渠道，也就是说：可能有的短信是通过腾讯云发送，有的是通过阿里云发送。这样就需要在工程中配置不同渠道的 SDK 依赖。

但这种方式会有两个明显的问题：

不同渠道的发送短信代码不一致，业务代码偏混乱。
工程中引入到 SDK 包比较多，不同的 SDK 依赖并不相同，可能存在冲突问题。

为了解决这个问题，有一种方法是摈弃三方渠道 SDK ，自己实现 SDK 的发送短信方法，这样可以统一发送短信代码，易于管理。

笔者发现一个开源项目 SMS4J，该项目为短信聚合框架，旨在集成多家短信服务，解决接入多个短信 SDK 的繁琐流程。

下面我们展示在 SpringBoot 环境如何集成。

maven 引入

<dependency>
 <groupId>org.dromara.sms4j</groupId>
 <artifactId>sms4j-spring-boot-starter</artifactId>
 <version>3.0.2</version>
</dependency>

设置配置文件

sms:
   alibaba:
      #阿里云的accessKey
      accessKeyId: 您的accessKey
      #阿里云的accessKeySecret
      accessKeySecret: 您的accessKeySecret
      #短信签名
      signature: 测试签名
      #模板ID 用于发送固定模板短信使用
      templateId: SMS_215125134
      #模板变量 上述模板的变量
      templateName: code
      #请求地址 默认为dysmsapi.aliyuncs.com 如无特殊改变可以不用设置
      requestUrl: dysmsapi.aliyuncs.com
   huawei:
      #华为短信appKey
      appKey: 5N6fvXXXX920HaWhVXXXXXX7fYa
      #华为短信appSecret
      app-secret: Wujt7EYzZTBXXXXXXEhSP6XXXX
      #短信签名
      signature: 华为短信测试
      #通道号
      sender: 8823040504797
      #模板ID 如果使用自定义模板发送方法可不设定
      template-id: acXXXXXXXXc274b2a8263479b954c1ab5
      #华为回调地址，如不需要可不设置或为空
      statusCallBack:
      #华为分配的app请求地址
      url: https://XXXXX.cn-north-4.XXXXXXXX.com:443
   zhutong:
      #助通短信
      #助通终端用户管理的用户名 username 必填；非登录账号密码，请登录后台管理地址进行查看：http://mix2.zthysms.com/login
      accessKeyId: tushu1122XXX
      #助通终端用户管理的用户名 passwrod 必填；
      accessKeySecret: UbXXX4SL
      #短信签名，可选；可选的时候，只能使用自定义短信不能使用模板短信； 具体在这里查看审核过的短信签名：https://mix2.zthysms.com/index.html#/SignatureManagement
      signature: 上海千XXXX

方法使用

@RestController
@RequestMapping(\"/test/\")
public class DemoController {
  // 测试发送固定模板短信
  @RequestMapping(\"/\")
  public void doLogin(String username, String password) {
     //阿里云向此手机号发送短信
     SmsFactory.createSmsBlend(SupplierType.ALIBABA).
                       sendMessage(\"18888888888\",\"123456\");
     //华为短信向此手机号发送短信
     SmsFactory.createSmsBlend(SupplierType.HUAWEI).
                       sendMessage(\"16666666666\",\"000000\");
  }
}

客户端模式是简单实用的模式，我们可以直接引入三方渠道的 SDK 发送短信，但当存在多种渠道短信时，可能代码会比较混乱。

虽然我们可以封装多个三方渠道接口来解决问题，但研发成本还是比较高的。

另外，当研发小组分散，发送短信各自自成体系时，当某一个渠道由于某种原因被弃用时，大部分研发小组都可能会受影响。

3 服务端模式

服务端模式是独立创建一个短信平台服务，应用服务直接使用短信平台提供的 SDK 发送短信。

短信平台的设计有如下要点：

1、应用管理

短信平台为每一个接入的应用分配单独的 appKey 和 appSecret ，每一个应用可以配置独立的限流策略。

2、精简的 SDK 提供按照模版单发/群发的功能

public SmsSenderResult sendSmsByTemplateId( 
                    String mobile, 
                    String templateId, 
                    MapString, String> templateParam);