國際/港澳台簡訊服務中的各類錯誤碼、SMPP回執狀態代碼及其解決方案。 - Short Message Service

本文檔旨在協助開發人員快速定位、診斷並解決在使用阿里雲國際/港澳台簡訊服務過程中遇到的各類錯誤。內容涵蓋從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	賬戶資訊不存在。	請確認是否開通簡訊服務且實名認證通過。
SMS_CONTENT_CODE_ILLEGAL	簡訊內容不合法（不存在或被拉黑）。	登入簡訊服務控制台。在左側導覽列，選擇发往中国大陆 > 短信内容。檢查審批狀態。如果是“未通過”狀態，請點擊创建新内容。
SMS_SIGN_NAME_ILLEGAL	簽名不合法（不存在或被拉黑）。	登入簡訊服務控制台。在左側導覽列，選擇发往中国大陆 > 短信签名。確認使用的簽名名稱是否與審核通過的完全一致。如果簽名是“未通過”狀態，查看原因後，請重新申請新的簽名。
MOBILE_NUMBER_ILLEGAL	手機號碼格式錯誤。	請校正號碼格式準確性，重新提交到平台。
MOBILE_COUNT_OVER_LIMIT	手機號碼數量超過1000條。	調用BatchSendMessageToGlobe的介面時，單次請求的號碼數量不能超過 1000 個。請分批調用。
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。