国际/港澳台短信服务中的各类错误码、SMPP回执状态码及其解决方案。-短信服务(SMS)-阿里云帮助中心

本文档旨在帮助开发者快速定位、诊断并解决在使用阿里云国际/港澳台短信服务过程中遇到的各类错误。内容涵盖从API调用、短信投递到状态回执的全链路错误码，并提供可执行的解决方案。

错误码概览与分类

说明

本文内容较多，可使用Ctrl/Command+F的方式查找指定错误码详情。
可以在发送记录查询页面查看每条消息发送的错误码信息及其描述。

为精准定位问题，首先需要理解短信发送生命周期中不同阶段可能出现的错误码类型。

常见错误码：在调用 SendMessageToGlobe 等 API 接口时，通过 HTTP 响应立即返回。这类错误码表明请求本身存在问题（如参数错误、权限不足），或者请求未被平台成功受理。
回执状态码：在短信被平台受理后，通过异步回执消息或调用 SmsReport 接口查询得到。这类状态码反映了短信从运营商到用户手机的最终投递结果（如成功、失败、被拦截）。
SMPP回执错误码：仅在使用 SMPP 协议方式接入时出现，用于表示 SMPP 命令的执行结果或消息的最终状态，严格遵循 SMPP 3.4 协议规范。

常见错误码

API错误码	描述	解决方案
OK	请求成功。	-
INVALID_SENDERID	SenderID无效或未通过审核。	登录短信服务控制台，在左侧导航栏，选择国际/港澳台短信 > 发送前 > SenderID。检查请求中使用的 SenderID 状态。确认 SenderID 是否为“审核通过”状态。检查调用时传入的SenderID 是否与审核通过的完全一致（区分大小写和空格）。
FORBIDDEN_ACTION	用户接口降级。	请提交工单，恢复接口正常调用能力。
OUT_OF_SERVICE	短信服务业务停机。	-
ACCOUNT_NOT_EXISTS	账户信息不存在。	请确认是否开通短信服务且实名认证通过。
MOBILE_NUMBER_ILLEGAL	手机号码格式错误。	请校验号码格式准确性，重新提交到平台。
CONTENT_MISSING_PARAMETERS	短信内容变量缺少对应参数值。	请检查 `TemplateParam` 参数，确保 JSON 结构中的 Key 与短信内容中定义的变量名（如 `${code}`）完全对应，且所有变量均已赋值。
INVALID_PARAMETERS	输入的参数异常。	请检查参数配置，保证参数的准确性。
INVALID_JSON_PARAM	参数为空，参数JSON串解析错误。	请检查参数配置，保证参数的准确性。
PARAM_LENGTH_LIMIT	短信内容变量长度受限。	检查短信内容中变量替换后的内容长度。确认单个变量内容是否超过 200 字符。计算所有变量替换后，短信总内容是否超过平台限制。
AMOUNT_NOT_ENOUGH	账户余额或资源包不足。	请购买套餐包或者充余额。
SYSTEM_ERROR	内部系统错误。	阿里云平台侧出现临时性错误。请稍后重试。若问题持续，请提交工单并提供 RequestId。
DATA_NOT_EXIST	查询的短信记录不存在。	请稍后重试。
QPS_LIMIT_CONTROL	到达系统QPS发送限制。	已达到单用户QPS上限，请根据调用情况合理调整QPS。
ONLINE_BILLING_FAILED	短信服务在线计费失败或者内部系统错误。	短信服务在线计费系统繁忙，请稍后再试。
QUERY_DATE_ILLEGAL	查询时间非法。	请检查参数配置，保证参数的准确性。
RAM_PERMISSION_DENY	RAM校验失败，用户权限不足。	请授权RAM调用接口全部的权限，重新尝试。
PRODUCT_NOT_SUBSCRIBED	短信服务还未开通。	登录短信服务控制台，开通短信服务。
SMS_SECURITY_INTERCEPTED	短信服务风控策略拦截。	-
SMS_CONTENT_ILLEGAL	短信内容不合法。	请检查短信发送内容是否符合相关法规要求。
ACCOUNT_ILLEGAL	账号由于发送非法内容被列入黑名单。	-
BLACK_KEY_CONTROL_LIMIT	短信内容变量中包含黑名单关键字。	变量内容触发了平台的安全策略。请检查并修改变量中包含的敏感词或不合规内容。
NOT_SUPPORTED_COUNTRY	暂不支持该国家的短信发送。	-
SENDERID_BLACKLISTED	使用的Sender ID被风控策略拦截。	-
IMDA_COMPANY_REQUIRE_LOA	使用的Sender ID需要报备IMDA。	请及时报备IMDA。
SYSTEM_LIMIT_CONTROL	到达系统每日发送限制。	-
FREQUENCY_LIMIT_DAY	到达单个号码每日发送频率限制。	请在控制台系统设置 > 通用设置 > 发送频率设置重新设置单个号码每日发送频率（上限20）。
ALERT_LIMIT_DAY	到达用户每日发送限制。	请在控制台系统设置 > 通用设置 > 发送阈值设置 > 全局配置重新设置每日短信发送总量。
ALERT_LIMIT_MONTH	到达用户每月发送限制。	请在控制台系统设置 > 通用设置 > 发送阈值设置 > 全局配置重新设置每月短信发送总量。
COUNTRY_TRAFFIC_LIMIT	到达用户每日发送地区的限制。	请在控制台系统设置 > 通用设置 > 发送阈值设置 > 路由管理重新设置地区每日短信发送总量。
CONTENT_EXCEED_LIMIT	内容字数超过系统最大限制。	请调整内容字数，字数大小限制在512k以内。
QUANTITY_INCONSISTENT	号码发送数量（接口字段To）和文本内容（接口字段Message）数量不一致。	请确保号码发送数量和文本数量保持一致。
Specified AccessKeyId is not found	AccessKeyId不存在。	请检查代码中配置的 AccessKeyId 是否正确、有效，且未被禁用。
REJECTED_SENDERID_NOT_AVAILABLE	请求中定义的发送者ID尚未在您的账户上注册。	登录短信服务控制台，在左侧导航栏，选择国际/港澳台短信 > 发送前 > SenderID。。检查请求中使用的 SenderID 是否已报备，并确认 SenderID 是否为“审核通过”状态。检查调用时传入的SenderID 是否与审核通过的完全一致（区分大小写和空格）。
LENGTH_LIMIT	内容超出长度限制。	短信内容超过长度限制，请简化到 1500 字符以内。
BILLING_DEDUCTION_ERROR	系统在尝试从你的账户中扣除本次服务费用时失败。	系统尝试从你的账户中扣除本次服务费用时失败，请稍后再试。

回执状态码

错误码	错误描述
success	发送成功。
IN_SMS_CONTENT	短信内容或长度错误。
INVALID_NUM	无效接收号码。
INVALID_SENDERID	无效Sender ID。
OPERATOR_NOT_SUPPORT	运营商不支持该电话号码。
PHONE_NOT_AVAILABLE	电话号码、手机不可用，或手机存储容量已满。
PORTED_NUM	电话号码的运营商已更改。
RECEIVER_BLACKLIST	接收号码被列入黑名单，被运营商阻止。
SYSTEM_ERR	供应商系统异常。
SP_UNKNOWN_ERROR	消息发送失败。
URL_FAILURE	URL被列入黑名单。
expired	由于客户手机长时间关机或停机，导致短信无法发送。
NO_VALID_SUPPLIER	无新加坡IMDA合规供应商支持。
DELIVERED_TO_HANDSET	短信已成功发送至收件人的移动设备。
REJECTED_RAM_PERMISSION_DENY	RAM子账户权限不足，无法执行此操作。请联系主账户管理员以授予必要的权限。
REJECTED_PREPAID_PACKAGE_EXPIRED	预付费套餐已过期。请续订或购买新的短信套餐以继续使用该服务。
REJECTED_ACCOUNT_NOT_EXISTS	手机账户不存在或已被禁用。请核实您的号码信息。
UNDELIVERED_OPERATOR_REJECTED	运营商拒绝了短信。可能原因：号码格式错误、号码被暂停或注销。请核实电话号码的有效性。
UNDELIVERED_NOT_DELIVERED	短信发送失败。这可能是由于网络问题或收件人设备异常。请稍后重试。
UNDELIVERED_INVALID_NUMBER	电话号码无效或不存在。请检查号码格式并确认其有效性。
SMS_FLOODING	检测到短信发送频率过高，已触发反垃圾短信保护功能。请降低发送频率，以避免短时间内大量发送。
REJECTED_SYSTEM_ERROR	内部系统错误导致短信发送失败。请稍后重试。如果问题仍然存在，请联系技术支持。
REJECTED_SENDERID_NOT_AVAILABLE	发件人ID不可用或尚未获得批准。请检查签名配置，并确保其已获得批准且适用于目标国家/地区
REJECTED_ROUTE_NOT_AVAILABLE	短信路由暂时不可用。这可能是由于目标运营商网络问题。请稍后重试或联系技术支持。
REJECTED_NOT_ENOUGH_CREDITS	账户余额不足，无法发送短信。请充值后再试。
REJECTED_MOBILE_COUNT_OVER_LIMIT	发送至单个电话号码的短信数量超出了限制。请减少向单个号码发送短信的频率。
REJECTED_ILLEGAL_CONTENT	短信内容包含违法或敏感信息，已被系统屏蔽。请修改内容并重新提交，确保内容符合当地法规。
REJECTED_FORBIDDEN_ACTION	当前操作被禁止。请检查手机账户状态或手机是否已拒绝短信。
REJECTED_FLOODING_CONTROL_AL	检测到短信发送频率过高，已触发反垃圾短信保护机制。请降低发送频率，以避免短时间内大量发送。
REJECTED_FLOODING_CONTROL	检测到短信发送频率过高，已触发反垃圾短信保护机制。请降低发送频率，以避免短时间内大量发送。
EXPIRED_EXPIRED	短信已过期且未能送达。请检查收件人的手机状态并重新发送。
EXPIRED_DLR_UNKOWN	短信发送状态无法确认，可能已过期。请稍后重试。
DON'T DISTURB	收件人处于“请勿打扰”时段。在“请勿打扰”时段结束之前，短信将不会发送。
DELIVERED_TO_OPERATOR	短信已成功提交至运营商网络。
DELIVERED	短信已成功送达。

SMPP回执错误码

SMPP消息状态	最后的消息状态	描述
DELIVERED	DELIVRD	消息发送至目的地。
EXPIRED	EXPIRED	消息有效期已到期。
DELETED	DELETED	消息已被删除。
UNDELIVERABLE	UNDELIV	消息无法送达。
ACCEPTED	ACCEPTD	消息处于接受状态。
UNKNOWN	UNKNOWN	消息处于无效状态。
REJECTED	REJECTD	消息处于拒绝状态。

更多信息，请参见SMPP协议规范V3.4。