阿里云短信服务教程

短信验证码发不出去，阿里用户注册卡在半路——这事我遇到过不止一次。云短后来换成阿里云短信服务，信服问题才算解决。阿里它的云短逻辑不复杂：你调用API，阿里云把短信推到用户手机。信服但真要跑通，阿里有几个坑得提前知道。云短

先搞定签名和模板

开通短信服务后，信服第一件事不是阿里写代码，是云短去控制台申请签名和模板。签名就是信服短信开头那个【某某科技】，模板则是阿里正文内容，比如“您的云短验证码是${ code}，5分钟内有效”。信服这两样都要审核，通常两小时内出结果。个人开发者注意：签名只能用已备案的域名或App名称，随便写个“测试”大概率被驳回。模板里的变量必须用${ }包起来，别自己发明格式。

AccessKey别硬编码在代码里

创建AccessKey时，阿里云会提醒你只显示一次Secret。很多人图省事直接写死在代码里，然后传到GitHub——第二天就收到欠费通知。正确做法是塞进环境变量，或者用RAM子账号加临时Token。我习惯在本地用.env文件，线上用KMS加密。别嫌麻烦，被盗刷的短信费够你喝一壶。

Python调用示例，直接能跑

官方SDK更新挺快，下面这段用最新的alibabacloud_dysmsapi20170525包。安装：pip install alibabacloud_dysmsapi20170525。代码里注意RegionId固定为cn-hangzhou，别改成别的。

from alibabacloud_dysmsapi20170525.client import Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_dysmsapi20170525 import models as dysms_models def send_sms(phone, code): config = open_api_models.Config( access_key_id=os.getenv('ALIYUN_AK'), access_key_secret=os.getenv('ALIYUN_SK') ) config.endpoint = 'dysmsapi.aliyuncs.com' client = Client(config) request = dysms_models.SendSmsRequest( phone_numbers=phone, sign_name='你的签名', template_code='SMS_123456789', template_param='{ "code":"%s"}' % code ) response = client.send_sms(request) return response.body.code == 'OK' 

返回的Code字段是“OK”才算成功。如果看到“isv.SMS_SIGNATURE_ILLEGAL”，说明签名没审核过或者填错了。 “isv.BUSINESS_LIMIT_CONTROL”则是触发流控，默认同一号码1分钟1条，1小时5条。想调整得提交工单，别自己瞎试。

那些文档没明说的细节

短信内容里带链接？审核基本不过。带“退订”字样？个人签名不支持。还有，模板变量长度别超过20个字符，否则会截断。我见过有人把整个JSON塞进变量里，结果用户收到一堆乱码。另外，阿里云短信默认走国内通道，发往港澳台或海外需要单独开通国际/港澳台短信，计费也不同。

最后说个真实案例：某次线上故障，用户收不到验证码，查日志发现API返回“OK”，但手机就是没动静。后来抓包发现是手机号前面多了个“+86”，而模板里已经带了国家码。去掉加号，立刻正常。这种问题文档不会写，只能自己踩。

短信服务本身不复杂，难的是细节。把签名模板审过，AccessKey管好，错误码看熟，基本就能稳定跑了。别等到用户投诉才去翻日志——那时候已经晚了。