国内 vs 国际短信通道接入：有哪些坑你踩过？

搞短信的这些年，接通道踩过的坑够写一本书了。本人首先声明这篇文章不是科普帖，也不是协议讲解贴，而是一个短信平台程序员站在“亲身踩坑”的角度，总结我在对接国内/国际短信通道过程中遇到的一些典型问题。
我们平台对接过的通道包括全国很多省份的运营商通道，国外运营商通道和很多不便点名的国内和国际合作伙伴通道。如果你也正在开发短信平台或对接通道，希望这篇文章能帮你少走点弯路。

首先，先来讲讲国内短信通道的“常见的坑”
1. 通道编码不统一（GBK、UTF-8、UNICODE）
国内某些旧版通道（尤其是早年移动CMPP通道）要求GBK编码，但你后台系统、数据库、API接口都可能是UTF-8。这个转码不统一的问题很容易导致短信内容乱码，尤其是模板变量带中文时，错误率高。
强烈建议：
明确各通道的编码要求（别听供应商说支持UTF-8就放心了）
发送前强制转码验证 + 内容长度截断校验

2. 同一模板不同签名不能复用
国内运营商要求“签名 + 模板 + 内容”三要素绑定。你用一个通道注册了“【某品牌】您的验证码是...”的模板，换成“【另一品牌】您的验证码是...”就算内容一样也不能用。
我的建议：
在模板设计层加上签名字段，不要只按“内容模版”做缓存和判断
配置中心设计为“签名+模板”绑定通道，而不是通道绑定模板

3. 替换变量位置敏感
有些通道，比如部分云平台服务商，对变量顺序、标识符（如${code} vs {1}）极度敏感。后台模板管理稍有不一致就导致通不过审核或报错。
建议：
模板变量格式由平台统一抽象，比如 {1}, {2}，所有变量通过索引顺序传参
模板和参数做双向校验：参数个数、是否为空、是否超长

4. 通道审核不稳定，模板更新滞后
大部分国内供应商对模板和签名都需要审核，而且可能几个小时甚至半天才更新。（25年以来因为运营商规则的变动，签名的审核一般都延长为2-5个工作日）
强烈建议：
实现模板状态轮询机制，支持模板创建后定时查询状态
做灰度发布：先测试通道通过后再切换正式流量

其次，国际短信通道的“高频炸雷点”

1. 编码与字符计费机制完全不同

有些国际通道采用的是GSM 7-bit 或 UCS-2 编码计费。比如你发了一条 100 个字符的中文短信，它很可能被编码成 UCS-2 并拆成 3 条独立计费。

建议：

构建短信预估长度与分条数计算模块

国际短信必须在平台层做内容压缩、优化表达（比如使用拼音）

2. 国际号码格式问题超严重

很多供应商要求严格的E.164 格式（如 +852XXXXXXXX），而不是你在表单里随手写的“0086”、“138xxxx”等。

建议：

所有国际短信号码先统一清洗为标准 E.164 格式

编写正则适配不同国家号码长度规则，防止非法号码被运营商拒收

3. 网络质量不可控，延迟和失败率波动大

国际通道普遍存在如下问题：

网络传输跨境，容易丢包或延迟

一些国家（如中东、非洲）有严格本地通道要求

某些国际供应商在特定国家没有直接落地节点，依赖“国际中继”，导致可用性比较差

建议：

每个国家配置多个通道，或者寻找有多通道策略的供应商（如主通道失败即转备选）

建立通道稳定的检查机制：成功率、回执时间、失败码分布等

4. 国际通道限制多，内容敏感词触发封号风险高

一些国际通道商对“政治、药品、金融”等内容有严重限制，哪怕是业务合法，只要含有相关关键字就可能触发拦截或封号。

建议：

内容审查做在发送前，结合敏感词库预检查

与国际供应商确认“行业灰名单”关键字列表

对不同国家/区域做白名单策略配置（如：某些地区不允许带URL）

第三，通用的坑：你必须考虑的底层机制问题

1. 幂等设计

验证码类短信重复点击容易导致多次发送，需要基于唯一业务ID或手机号+场景+时间窗口做幂等控制。

2. 回执处理机制

部分通道不支持回执，或只返回最终状态（成功/失败）但无中间状态。系统必须能区分“已投递或回执丢失或投递失败”。

建议：

引入“消息状态轮转机制”：待发 → 已发 → 待回执 → 完成/失败

支持超时判断 + 自动补偿 + 上报失败原因（运营商错误码）

3. 通道评估算法

建议实现通道打分机制（成功率、延迟、成本），对多个通道做实时动态路由（这个内容可以参考我另外一篇文章《如何构建一个自定义短信通道调度算法-从固定权重到智能打分》有详细的讲解）

最后，再啰嗦几句

短信通道不是“打通就能用”的模块，尤其在对接国际业务后，才发现它涉及

协议适配（HTTP/CMPP/SMPP）/编码规则/各国监管合规/网络质量差异/模板审核与内容限制等，欢迎留言交流！