Java短信发送全攻略：5种主流API对比与完整代码实现

admin 2025-06-26 阅读:12 评论:0

Java实现短信发送功能：从API集成到阿里云短信服务实战指南在当今互联网应用中，短信功能已成为用户注册、身份验证、通知提醒等场景的刚需。本文将全面解析Java环境下实现短信发送的多种技术方案，包含完整代码示例和最佳实践建议。一、Java...

Java实现短信发送功能：从API集成到阿里云短信服务实战指南

在当今互联网应用中，短信功能已成为用户注册、身份验证、通知提醒等场景的刚需。本文将全面解析Java环境下实现短信发送的多种技术方案，包含完整代码示例和最佳实践建议。

一、Java发送短信的5种主流方案对比

第三方短信API集成
阿里云短信服务（推荐）
腾讯云短信
云片网
创蓝253
聚合数据
运营商直连协议
SMPP协议
CMPP协议（中国移动）
SGIP协议（中国联通）
短信猫硬件方案
基于AT指令的GSM Modem
适合小规模本地化部署
邮件转短信网关
通过邮件接口转发到短信
适合企业内部通知
虚拟运营商接口
如阿里大于、腾讯云通信

二、阿里云短信服务Java SDK集成实战

1. 准备工作

注册阿里云账号
开通短信服务
获取AccessKey ID/Secret
申请短信签名和模板

2. Maven依赖配置

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.3</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-dysmsapi</artifactId>
    <version>2.1.0</version>
</dependency>

3. 完整发送代码示例

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsRequest;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;

public class AliyunSmsSender {

    // 替换为你的AccessKey信息
    private static final String ACCESS_KEY_ID = "your_access_key_id";
    private static final String ACCESS_KEY_SECRET = "your_access_key_secret";

    public static SendSmsResponse sendSms(String phone, String templateCode, 
            String templateParam) throws ClientException {

        // 初始化acsClient
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-hangzhou", ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        IAcsClient client = new DefaultAcsClient(profile);

        // 组装请求对象
        SendSmsRequest request = new SendSmsRequest();
        request.setPhoneNumbers(phone);
        request.setSignName("你的签名");
        request.setTemplateCode(templateCode);
        request.setTemplateParam(templateParam);

        // 发送请求并获取响应
        return client.getAcsResponse(request);
    }

    public static void main(String[] args) {
        try {
            // 示例：发送验证码
            String response = sendSms("13800138000", "SMS_12345678", 
                "{\"code\":\"1234\"}");
            System.out.println("短信发送结果：" + response);
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

三、短信发送功能进阶优化

1. 发送频率控制

// 使用Guava RateLimiter限流
RateLimiter limiter = RateLimiter.create(1.0); // 每秒1条
if (limiter.tryAcquire()) {
    // 发送短信
} else {
    throw new RuntimeException("发送频率过高");
}

2. 短信发送队列

建议使用消息队列（如RabbitMQ）异步处理短信发送请求，避免阻塞主业务流程。

3. 发送结果持久化

将发送记录存入数据库，便于后续查询和统计：

Java短信发送全攻略：5种主流API对比与完整代码实现

CREATE TABLE sms_log (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    phone VARCHAR(20) NOT NULL,
    content TEXT,
    template_id VARCHAR(50),
    send_time DATETIME DEFAULT CURRENT_TIMESTAMP,
    status TINYINT COMMENT '0-失败 1-成功',
    biz_id VARCHAR(50) COMMENT '运营商返回ID',
    error_msg VARCHAR(255)
);