在很多項目中，短信通知、驗證碼下發(fā)或業(yè)務提醒都是系統(tǒng)的關鍵環(huán)節(jié)。但現(xiàn)實往往不那么美好——不同短信服務商的 SDK 千差萬別：

• 阿里云短信：要配置 AccessKey、簽名、模板 ID；
• 騰訊云短信：要綁定應用 ID、應用密鑰；
• 華為云短信：又有自己的一套參數(shù)和認證流程。

這意味著——只要你換一個廠商，就得重新讀文檔、改代碼、調接口，耗時又易出錯。而且配置項一堆，不僅格式不統(tǒng)一，還會隨著版本或業(yè)務調整而變化。對于需要在多環(huán)境（開發(fā)、測試、生產(chǎn)）部署的項目來說，簡直是一場災難。

有沒有辦法讓我們只關注業(yè)務，而不用在 SDK 泥潭里掙扎？ 答案就是 —— SMS4J：為 Spring Boot 打造的通用短信聚合框架。

SMS4J：統(tǒng)一多廠商短信的“智能中樞”

SMS4J 的定位非常明確：它幫你屏蔽底層差異，讓所有短信服務商在項目里都能“一個接口全搞定”。

你可以理解它為一個“短信路由中心”，阿里云、騰訊云、華為云等廠商都能無縫接入。 開發(fā)者不再需要學習多個 SDK，只需通過統(tǒng)一配置和接口調用，就能輕松完成短信發(fā)送。

它的兩大核心亮點是：

• 多廠商全覆蓋：內(nèi)置對阿里云、騰訊云、華為云、京東云、容聯(lián)云、網(wǎng)易云信、天翼云等主流短信平臺的支持。無需額外引入廠商 SDK。
• 配置即用：所有配置集中在 application.yml，只要填好密鑰、簽名、模板即可發(fā)短信，連一行額外業(yè)務代碼都不用寫。

從零上手，只需 3 步

想讓 Spring Boot 項目具備多廠商短信能力？三步即可搞定。

引入依賴（pom.xml）

無需額外引 SDK，只需引入 SMS4J 官方 Starter：

<!-- 短信聚合框架 sms4j -->
<dependency>
    <groupId>org.dromara.sms4j</groupId>
    <artifactId>sms4j-spring-boot-starter</artifactId>
    <version>3.3.5</version>
</dependency>

這一步完成后，Spring Boot 啟動時會自動加載短信配置和相關 Bean，無需手動初始化。

在 YAML 中配置廠商信息

無論你想接阿里云、騰訊云，還是雙備份并存，都只需在配置文件中定義：

sms:
  config-type: yaml  # 指定從 YAML 中讀取配置
  blends:
    aliyunConfig:
      supplier: aliyun
      accessKeyId: yourAccessKeyId
      accessKeySecret: yourAccessKeySecret
      signature: "你的短信簽名"
      templateId: "你的模板ID"
      templateName: "模板變量名"
      requestUrl: dysmsapi.aliyuncs.com
    tencentConfig:
      supplier: tencent
      access-key-id: yourTencentAccessKeyId
      access-key-secret: yourTencentAccessKeySecret
      signature: "你的短信簽名"
      template-id: "你的騰訊云模板ID"
      sdk-app-id: "你的SDK應用ID"

?? 配置解析要點：

• config-type: 告訴框架從 YAML 讀取短信配置。若錯誤，服務將無法初始化。
• blends: 定義多個短信供應商配置，可按項目需求命名。
• supplier: 指定廠商類型（aliyun / tencent / huawei 等）。
• accessKeyId / accessKeySecret: 用于身份驗證的密鑰。請妥善保管。
• signature: 短信簽名，必須通過平臺審核。
• templateId: 對應短信模板 ID，不同業(yè)務用不同模板。
• templateName: 模板中變量的名稱。
• requestUrl: 廠商服務端點，一般保持默認即可。

通過這種統(tǒng)一配置結構，即便要新增廠商，也只需多寫一個配置塊，不用改一行 Java 代碼。

編寫發(fā)送邏輯（極簡調用）

下面的控制器示例展示了如何在項目中快速調用短信服務：

package com.icoderoad.sms.controller;


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.RestController;


@RestController
public class SmsController {


    @GetMapping("/sendSms")
    public String sendSms() {
        // 1. 獲取阿里云短信實例
        SmsBlend aliyunSms = SmsFactory.getSmsBlend("aliyunConfig");


        // 2. 發(fā)送短信（手機號 + 模板變量）
        SmsResponse aliyunResponse = aliyunSms.sendMessage("13800138000", "程序員小路");


        if (aliyunResponse.getCode() == 0) {
            return "阿里云短信發(fā)送成功";
        }


        // 3. 若失敗，嘗試騰訊云備用通道
        SmsBlend tencentSms = SmsFactory.getSmsBlend("tencentConfig");
        SmsResponse tencentResponse = tencentSms.sendMessage("13800138000", "程序員小路");


        if (tencentResponse.getCode() == 0) {
            return "騰訊云短信發(fā)送成功";
        }


        return "短信發(fā)送失敗，阿里云原因：" + aliyunResponse.getMsg() + "；騰訊云原因：" + tencentResponse.getMsg();
    }
}

說明：

• SmsFactory.getSmsBlend("aliyunConfig") 用于獲取指定配置的短信服務實例。
• sendMessage() 傳入手機號與模板參數(shù)，即可發(fā)出短信。
• 多廠商共用邏輯統(tǒng)一，業(yè)務層完全無感。

真正解決的 3 個痛點

1.成本可控 不同廠商價格策略差異大。你可以靈活切換：

• 阿里云驗證碼短信 ￥0.04 / 條；
• 騰訊云新用戶優(yōu)惠價更低。 使用 SMS4J 可按場景自動選擇最優(yōu)廠商。

2.高可用與容災 某廠商接口異常？一句切換即可：

SmsFactory.getSmsBlend("tencentConfig");

無需改動業(yè)務代碼，立即生效。

3.降低重復開發(fā)成本 新增廠商只需加配置，不用寫 SDK 適配。 系統(tǒng)維護成本顯著下降，模塊更易擴展。

常見問題排查速查表

總結：讓短信接入回歸“配置工程”

過去，我們?yōu)榱藢佣绦牌脚_而不得不：

• 引入多個 SDK；
• 學習不同接口；
• 調各種奇怪的 JSON；
• 被簽名、模板審核折磨。

而現(xiàn)在，SMS4J 讓一切變得簡單：

• 統(tǒng)一配置；
• 統(tǒng)一接口；
• 即插即用。

這不僅節(jié)省了開發(fā)與運維成本，還讓短信系統(tǒng)具備更高的靈活性與可維護性。 無論是企業(yè)級系統(tǒng)還是個人項目，都值得你在 Spring Boot 項目中一試。

尾語 

短信不再是瓶頸，而是開發(fā)效率的助推器。 用 SMS4J 打造一個真正可切換、可擴展、可維護的多廠商短信網(wǎng)關—— 讓每一次短信發(fā)送，都成為你系統(tǒng)穩(wěn)定與高效的體現(xiàn)。