Node.js对接Clickatell：短信显示发至网关但未送达求助

我之前在做Clickatell Node.js集成的时候也遇到过一模一样的问题——网关返回成功但用户收不到短信。结合踩过的坑和官方文档的细节，给你几个具体的排查方向：

• 确认测试号码的合规性
  Clickatell的测试环境对号码格式要求很严格，必须使用完整的国际格式（比如中国号码是+86xxxxxx，美国是+1xxxxxx），而且不能用虚拟号码、VoIP号码或者被运营商标记的号码。很多运营商会直接拦截这类非实体号码的测试短信，建议先换一个正常的实体手机号试试。

• 核对API调用的参数细节
  仔细检查你调用Node.js SDK时的参数，别忽略这些容易踩坑的点：

  • 确保to字段没有空格、括号等特殊字符，纯数字加国家代码前缀
  • 如果发送的是营销类内容，测试环境可能会自动拦截，先换成简单的测试文本（比如Test message from Clickatell）试试
  • 确认你的apiKey或authToken是正确的，虽然Clickatell通常会对无效密钥返回错误，但偶尔会出现“假成功”的边缘情况，导致短信根本没进入路由流程

• 查看Clickatell后台的详细日志
  别只依赖API返回的“已提交到网关”提示，登录Clickatell后台，找到Reports或Logs板块，查看每条短信的具体状态。日志里会显示是否被运营商拒绝、号码是否无效、路由是否异常等细节——如果状态是Failed，后面的错误描述会直接告诉你问题根源，比如“Invalid number”或“Carrier rejected”。

• 确保投递类型设置正确生效
  你设置了“Time critical delivery”，但要确认这个全局设置没有被API请求的参数覆盖。有些情况下，代码里显式设置的priority字段会替代后台的全局配置，建议在API请求里强制加上priority: 1（对应Time critical级别），确保投递优先级生效。

• 区分测试环境和生产环境的限制
  Clickatell的测试账户有发送限制，比如每日发送量上限、仅支持特定测试号码等。如果测试环境一直有问题，可以切换到生产环境的试用额度试试——生产环境的路由策略更稳定，运营商拦截的概率也更低。

• 更新Node.js SDK到最新版本
  旧版本的SDK可能存在API兼容性问题，比如和Clickatell最新的REST API端点不匹配，导致短信提交后无法正确路由。执行npm update clickatell更新到最新版，然后重新测试。

内容的提问来源于stack exchange，提问作者Konstantin Korolev