阿里云短信服务从入门到精通：完整对接使用指南

一、认识阿里云短信服务

阿里云短信服务是阿里云提供的一种稳定可靠、高到达率的企业级通信服务。它支持调用API或使用群发助手发送验证码、通知类和营销类短信，国内验证短信秒级触达，到达率最高可达99%；国际短信覆盖200多个国家和地区。短信服务历经双十一等极端场景考验，为全球数百万企业提供稳定可靠的通信服务。

短信服务主要应用于以下场景：用户注册与登录的验证码发送、订单状态变更通知、服务到期提醒、预约确认、会员活动营销等。无论是ToC还是ToB业务，短信都是连接企业与用户的重要桥梁。

需要注意的是，阿里云短信服务目前仅支持企业认证账号使用。个人认证用户功能受限，无法发送营销短信，且可能影响签名审核通过率。如果个人认证用户仅需发送验证码短信，也可以考虑申请开通阿里云号码认证服务的短信认证功能。

需要先登录阿里云控制台，点击：阿里云控制台

二、整体接入流程概览

通过阿里云发送短信，整体流程可以分为以下几个核心步骤：

• 账号准备与开通服务：注册阿里云账号、完成企业实名认证、开通短信服务
• 申请资质：提交企业营业执照等资质材料，审核通过后方可申请签名
• 申请短信签名：创建签名并等待审核通过（最快24小时）
• 申请短信模板：创建模板并等待审核通过（约2-4小时）
• 购买资源包或充值：确保账户有足够余额
• 发送短信：通过控制台群发助手或API/SDK程序化发送

从2025年起，中国大陆新增短信签名必须完成运营商实名报备（5-10个工作日），请提前规划。

三、准备工作

3.1 注册账号与企业实名认证

访问阿里云官网注册阿里云账号。完成注册后，需要进行企业实名认证。个体工商户通常也算企业认证。实名认证是开通短信服务的硬性门槛。

3.2 开通短信服务

在阿里云产品列表中找到短信服务并开通。登录短信服务控制台，根据提示完成服务开通。

3.3 购买资源包或确保余额充足

短信服务计费方式分为按量计费和套餐包两种。国际站默认采用短信资源包付费模式，需要先购买资源包。如果有短信套餐包则先扣除套餐包，超出套餐包额度后按量计费，扣除账户余额。建议根据业务需要选择最优的计费方案。

3.4 创建RAM用户并获取AccessKey

AccessKey是调用API的凭证。强烈建议使用RAM子用户的AccessKey，并授予其AliyunDysmsFullAccess权限策略。这比直接使用主账号的AK更安全。

创建RAM用户的步骤：

• 访问RAM控制台创建子用户
• 为该子用户设置对应的权限，推荐授予AliyunDysmsFullAccess短信管理权限
• 获取该子用户的AccessKey ID和AccessKey Secret

安全最佳实践：使用环境变量存储AccessKey（禁止硬编码）、定期轮换密钥、遵循最小权限原则。

四、申请资质

短信资质是阿里云对发送方身份的基础审核，相当于确认\"你是谁\"。企业需要提交营业执照或相关证件，阿里云会审核企业信息的真实性。资质审核通过后，才能进入签名和模板的申请环节。

申请资质需要填写的信息：单位名称、单位法人姓名、单位法人身份证号、有效期、单位管理人手机号。需要上传的材料：单位营业执照、单位法人身份证正反面、单位管理人身份证正反面。

资质审核预计需2个工作日。当使用场景非该阿里云账户企业、属于第三方公司的业务时，需要先申请相关他用资质。

五、申请短信签名

短信签名就是用户收到短信时，最前面方括号里的那个名字，比如〖淘宝〗、〖菜鸟网络〗。它是短信发送方的身份标识，让用户知道这条短信是谁发的。签名必须与提交的资质相匹配。

签名申请需要注意的要点：

• 签名必须体现业务属性：比如\"XX科技\"会被拒，而\"XX科技验证码\"就能通过
• 不能包含联系方式：类似\"联系客服138xxxx\"通不过
• 金融类业务需要特殊资质：涉及支付、理财等关键词需额外提交金融许可证

首次申请建议选择\"验证码\"类签名，通过率最高。签名审核通常需2小时。在\"国内消息\"或\"国际/港澳台消息\"菜单下申请。

从2025年起，短信签名审核通过后，阿里云会自动向运营商发起实名制报备。这个流程平均需要5-7个工作日，部分情况可能需要7-10个工作日或更长。报备期间，签名无法用于发送短信。

六、申请短信模板

如果说签名解决的是\"谁发的\"的问题，那模板解决的就是\"发什么\"。阿里云短信服务不允许自由填写短信内容，所有发送的短信都必须基于已审核通过的模板。

模板内容支持变量占位符，用variable的格式表示。比如验证码模板可以写成：\"您的验证码为：{variable}的格式表示。比如验证码模板可以写成：\"您的验证码为：{code}，5分钟内有效。\"其中${code}在实际发送时会被替换为真实的验证码数字。需要注意的是，变量名不能使用mobile、email等敏感词，否则审核可能不通过。

模板审核通常需2小时。国内短信模板与国际/港澳台短信模板不通用，不能混用。模板审核通过后不允许修改，只能删除。删除短信模板后不可恢复，请谨慎操作。

七、发送短信

7.1 控制台发送（群发助手）

控制台提供\"群发助手\"功能，适用于人工发送系统通知或营销短信。操作步骤：

• 登录短信服务控制台，左侧导航栏选择群发助手
• 点击创建发送任务，填写场景类型、任务名称、短信内容等参数
• 短信内容可包含变量，格式name，如：尊敬的{name}，如：尊敬的{name}，您的快递…
• 接收号码支持文件导入或手动输入（最多100个号码）
• 可预设定时发送时间

7.2 API/SDK程序化发送

对于开发者，推荐使用阿里云官方SDK集成短信发送能力。SDK封装了请求签名、异常重试等底层逻辑。阿里云短信服务支持Java、PHP、Python、Node.js、C#等多种语言。

下面以Java和Python两种语言为例，详细介绍SDK的集成方法。

7.2.1 Java SDK集成示例

环境要求：Java版本需高于Java 8。

第一步：在pom.xml中添加Maven依赖：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>dysmsapi20170525</artifactId>
    <version>2.0.24</version>
</dependency>

第二步：在application.yml中配置参数：

aliyun:
  sms:
    access-key-id: your-access-key-id
    access-key-secret: your-access-key-secret
    endpoint: dysmsapi.aliyuncs.com
    sign-name: 你的签名
    template-code: SMS_123456789

第三步：创建配置类初始化SDK客户端：

import com.aliyun.dysmsapi20170525.Client;
import com.aliyun.teaopenapi.models.Config;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class AliyunSmsConfig {
    
    @Value("${aliyun.sms.access-key-id}")
    private String accessKeyId;
    
    @Value("${aliyun.sms.access-key-secret}")
    private String accessKeySecret;
    
    @Value("${aliyun.sms.endpoint}")
    private String endpoint;
    
    @Bean
    public Client smsClient() throws Exception {
        Config config = new Config()
            .setAccessKeyId(accessKeyId)
            .setAccessKeySecret(accessKeySecret)
            .setEndpoint(endpoint);
        return new Client(config);
    }
}

第四步：编写发送短信的Service：

import com.aliyun.dysmsapi20170525.Client;
import com.aliyun.dysmsapi20170525.models.SendSmsRequest;
import com.aliyun.dysmsapi20170525.models.SendSmsResponse;
import com.aliyun.tea.TeaException;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
@Service
public class SmsService {
    
    @Autowired
    private Client smsClient;
    
    @Value("${aliyun.sms.sign-name}")
    private String signName;
    
    @Value("${aliyun.sms.template-code}")
    private String templateCode;
    
    public SendSmsResponse sendSms(String phoneNumber, String templateParam) {
        SendSmsRequest request = new SendSmsRequest()
            .setPhoneNumbers(phoneNumber)
            .setSignName(signName)
            .setTemplateCode(templateCode)
            .setTemplateParam(templateParam);
        
        try {
            return smsClient.sendSms(request);
        } catch (TeaException e) {
            System.err.println("发送短信失败：" + e.getMessage());
            throw new RuntimeException("短信发送异常", e);
        }
    }
}

第五步：在Controller中调用：

@RestController
@RequestMapping("/api/sms")
public class SmsController {
    
    @Autowired
    private SmsService smsService;
    
    @PostMapping("/send")
    public ResponseEntity<String> send(@RequestParam String phone, @RequestParam String code) {
        String templateParam = "{\"code\":\"" + code + "\"}";
        SendSmsResponse response = smsService.sendSms(phone, templateParam);
        return ResponseEntity.ok("发送成功，BizId：" + response.getBody().getBizId());
    }
}

7.2.2 Python SDK集成示例

环境要求：Python版本>=3.7。

第一步：安装SDK：

pip install aliyun-python-sdk-core-v3
pip install aliyun-python-sdk-dysmsapi

第二步：编写发送短信代码：

from aliyunsdkcore.client import AcsClient
from aliyunsdkdysmsapi.request.v20170525 import SendSmsRequest
import json
# 配置AccessKey
access_key_id = 'your-access-key-id'
access_key_secret = 'your-access-key-secret'
region_id = 'cn-hangzhou'
# 创建客户端
client = AcsClient(access_key_id, access_key_secret, region_id)
# 构建请求
request = SendSmsRequest.SendSmsRequest()
request.set_AcceptFormat('json')
request.set_PhoneNumbers('13800138000')
request.set_SignName('你的签名')
request.set_TemplateCode('SMS_123456789')
request.set_TemplateParam(json.dumps({"code": "123456"}))
# 发送请求
try:
    response = client.do_action_with_exception(request)
    print("发送成功：" + response.decode('utf-8'))
except Exception as e:
    print("发送失败：" + str(e))

八、安全与限流配置

8.1 RAM权限管理

推荐的做法是使用RAM身份（即RAM用户和RAM角色）来访问短信服务，避免直接使用阿里云主账号。这种方法不仅提升了安全性，还便于进行更精细的权限管理。

短信服务相关的系统权限策略：

• AliyunDysmsFullAccess：管理短信服务的权限
• AliyunDysmsReadOnlyAccess：只读访问短信服务的权限

如果默认的系统策略不满足需求，可以创建自定义权限策略，实现更细粒度的权限控制。

8.2 QPS限流

短信服务API有QPS限制：

• 套餐包模式：单用户QPS限制为30次/秒
• 按量付费模式：单用户QPS限制为2000次/秒

同一主账号及其所有RAM用户共享上述QPS限额。如果业务需要更高的并发量，建议升级到按量付费模式或联系阿里云提升限额。

8.3 发送频率限制

短信服务对发送频率有严格限制：

• 单号码限频：1天20条
• 验证码同一号码最多1条/分钟

可以在控制台设置日发送量总量阈值和月发送量总量阈值。同时可开启验证码防盗刷监控，防止恶意攻击。

九、回执消息配置

回执消息是在使用API接口发送短信之后，通过配置轻量消息队列（原MNS）消费模式或HTTP批量推送模式，帮助您掌握短信的发送成功率。

回执消息的两种接收方式：

• MNS消息队列消费模式：通过轻量消息队列的Queue模型来接收指定地域的短信回执消息
• HTTP批量推送模式：阿里云将回执消息通过HTTP请求推送到您指定的URL地址

配置回执消息后，可以实时获取短信的发送状态（成功、失败、运营商返回码等），便于业务系统进行后续处理和数据统计分析。

十、常见错误码排查

调用短信服务API接口失败时会返回错误码，以下是一些常见的错误码及解决方案：

• isv.SMS_SIGNATURE_SCENE_ILLEGAL：签名和模板类型不一致。模板和签名类型必须匹配
• InvalidTemplateCode：模板ID无效或未通过审核。检查模板ID是否正确，确认模板已审核通过
• 账号欠费：账户余额不足。检查账户余额，充入相应金额
• 权限不足：AK/SK没有授权管理短信服务的权限。检查RAM用户是否已授予AliyunDysmsFullAccess权限
• 签名未通过审核：签名状态不是\"审核通过\"。在控制台确认签名已通过审核

发送失败时，建议首先检查API错误码和错误信息进行定位。更详细的问题排查可以通过订阅回执消息，参考短信发送状态回执错误码查看问题原因和解决方案。

十一、成本优化建议

短信服务计费主要涉及发送条数。以下是一些成本优化的建议：

• 选择合适的计费方式：高频发送场景建议购买套餐包，单价更低；低频场景可选择按量付费
• 套餐包优先抵扣：系统会优先消耗套餐包额度，超出部分按量计费
• 关注套餐包余量：在控制台套餐包统计界面查看余量，及时续购避免按量高价
• 合理设置发送频率：避免不必要的重复发送，节省成本
• 利用测试环境：控制台提供专用的测试签名和测试模板，支持发送测试短信，帮助您在测试阶段免去签名和模板的申请环节

十二、国际短信注意事项

国际短信流程相对简化，大部分国家和地区无需预先申请签名和模板。但仍需注意以下事项：

• 印度：需要完成DLT注册
• 沙特阿拉伯：需要预注册Sender ID
• 美国/加拿大：推荐使用当地号码（长码/短码）以提高到达率
• 其他国家或地区：具体的合规要求以控制台页面显示为准

十三、常见问题问答

问：个人认证用户可以开通短信服务吗？

答：阿里云短信服务目前仅支持企业认证账号使用。个人认证用户功能受限，无法发送营销短信。建议升级为企业认证，或申请他用资质。

问：签名和模板审核需要多长时间？

答：签名审核通常需2小时，模板审核通常需2小时。但运营商实名报备需5-10个工作日。建议提前规划时间。

问：如何获取AccessKey？

答：在RAM控制台创建RAM子用户，勾选\"编程访问\"，系统会自动生成AccessKey ID和AccessKey Secret。创建后请妥善保管Secret，不支持二次查看。

问：发送短信失败如何排查？

答：首先查看API返回的错误码和错误信息。常见原因包括：签名或模板未审核通过、账户余额不足、AK/SK权限不足、QPS超限等。也可通过订阅回执消息获取详细状态。

问：短信服务如何计费？

答：计费方式分为按量计费和套餐包两种。先扣除套餐包额度，超出部分按量计费。国内验证码短信低至0.045元/条起。具体价格以官网为准。

问：如何防止短信被盗刷？

答：可在控制台设置日发送量总量阈值和月发送量总量阈值。开启验证码防盗刷监控。同时建议设置验证码短信发送频率限制。使用RAM子账号并遵循最小权限原则也能降低风险。