調用短信服務API接口失敗時會返回錯誤碼，請根據錯誤碼和錯誤信息排查問題。
錯誤碼（Code） | 錯誤信息（Message） | 原因及解決方案 |
isv.SMS_SIGNATURE_SCENE_ILLEGAL | 簽名和模板類型不一致 | 原因：模板和簽名類型不一致。錯誤示例：用驗證碼簽名發送了通知短信或推廣短信。 解決方案：簽名分為驗證碼和通用兩種類型。模板分為驗證碼、短信通知和推廣短信三種類型。 其中驗證碼類簽名只能發送驗證碼模板，通用類簽名可以發送全部類型的模板。建議您把簽名更改為通用類型。 |
isv.EXTEND_CODE_ERROR | 擴展碼使用錯誤，相同的擴展碼不可用于多個簽名 | 原因：發送短信時，不同簽名的短信使用了相同的擴展碼。 解決方案：在調用短信發送接口時，不同的短信簽名使用不同的擴展碼。 |
isv.DOMESTIC_NUMBER_NOT_SUPPORTED | 國際/港澳臺消息模板不支持發送境內號碼 | 原因：國際/港澳臺消息模板僅支持發送國際、中國港澳臺地區的號碼。 解決方案：如果要發送中國內地短信，請申請國內消息短信模板。 |
isv.DENY_IP_RANGE | 原IP地址所在的地區被禁用 | 原因：被系統檢測到原IP屬于非中國內地地區。 解決方案：請將原IP地址修改為中國內地地區的IP地址。國際/港澳臺的IP地址禁止發送中國內地短信業務。更多詳情，請參見服務接入點。 |
isv.DAY_LIMIT_CONTROL | 觸發日發送限額 | 原因：已經達到您在控制臺設置的短信日發送量限額值。 解決方案：如果需要修改限額，請登錄短信服務控制臺，在頁面，修改日發送量總量閾值。 |
isv.MONTH_LIMIT_CONTROL | 觸發月發送限額 | 原因：已經達到您在控制臺設置的短信月發送量限額值。 解決方案：如果需要修改限額，請登錄短信服務控制臺，在頁面，修改月發送量總量閾值。 |
isv.SMS_CONTENT_ILLEGAL | 短信內容包含禁止發送內容 | 原因：短信內容包含禁止發送內容。 解決方案：修改短信文案，規范詳情請參見短信模板規范。 |
isv.SMS_SIGN_ILLEGAL | 簽名禁止使用 | 原因：簽名禁止使用。 |
isp.RAM_PERMISSION_DENY | RAM權限不足 | 原因：RAM權限不足。 解決方案：請為當前使用的AccessKey對應的RAM用戶進行授權：AliyunDysmsFullAccess（管理權限）。具體操作請參見授權RAM用戶。 |
isv.OUT_OF_SERVICE | 業務停機 | 原因：余額不足導致的業務停機，更多詳情請參見欠費說明。 解決方案：請及時充值。 |
isv.PRODUCT_UN_SUBSCRIPT | 未開通云通信產品的阿里云客戶 | 原因：該AccessKey所屬的賬號尚未開通云通信的服務，包括短信、語音、流量等服務。 解決方案：當出現此類報錯信息時，需要檢查當前AccessKey是否已經開通阿里云短信服務。如果已開通短信服務，請調用接口即可。 |
isv.PRODUCT_UNSUBSCRIBE | 產品未開通 | 原因：該AccessKey所屬的賬號尚未開通當前接口的產品，如僅開通了短信服務的用戶調用語音服務接口時會產生此報錯信息。 |
isv.ACCOUNT_NOT_EXISTS | 賬戶不存在 | 原因：使用了錯誤的賬戶名稱或AccessKey。 解決方案：請確認賬號信息。 |
isv.ACCOUNT_ABNORMAL | 賬戶異常 | 原因：賬戶異常。 解決方案：計費服務查詢異常，請點擊鏈接，打開釘釘掃碼進入短信服務專屬釘群。 |
isv.SMS_TEMPLATE_ILLEGAL | 請檢查模板內容與模板參數是否匹配 | 原因：
解決方案： |
isv.SMS_SIGNATURE_ILLEGAL | 該賬號下找不到對應簽名 | 原因：
|
isv.INVALID_PARAMETERS | 參數格式不正確 | 原因：參數格式不正確。 解決方案：請根據對應的API文檔檢查參數格式。 如，短信查詢QuerySendDetails接口的參數SendDate日期格式為yyyyMMdd，正確格式為20170101，錯誤格式為2017-01-01。 |
isp.SYSTEM_ERROR | 系統出現錯誤，請重新調用 | 原因：系統出現錯誤。 解決方案：請重新調用接口。 |
isv.MOBILE_NUMBER_ILLEGAL | 手機號碼格式錯誤 | 原因：手機號碼格式錯誤。 解決方案：參數PhoneNumbers請傳入正確的格式。
|
isv.MOBILE_COUNT_OVER_LIMIT | 調用接口時參數PhoneNumbers中指定的手機號碼數量超出限制。 | 原因：參數PhoneNumbers中指定的手機號碼數量超出限制。 解決方案：
|
isv.TEMPLATE_MISSING_PARAMETERS | 模板變量中存在未賦值變量 | 原因：參數TemplateParam中，變量未全部賦值。 解決方案：請用JSON格式字符串為模板變量賦值。如：模板為您好${name}，驗證碼${code}，則參數TemplateParam可以指定為{"name":"Tom","code":"123"}。 |
isv.BUSINESS_LIMIT_CONTROL | 觸發云通信流控限制 | 原因：達到云通信短信發送頻率上限。 解決方案： |
isv.INVALID_JSON_PARAM | 參數格式錯誤，請修改為字符串值 | 原因：參數格式錯誤，不是合法的JSON格式，修改為字符串值。 解決方案：請在參數TemplateParam中指定正確的JSON格式字符串，比如 |
isv.BLACK_KEY_CONTROL_LIMIT | 黑名單管控 | 原因：黑名單管控是指短信號碼命中黑名單，此類號碼曾有過退訂或投訴記錄，不支持下發該類推廣短信。 解決方案：推廣短信建議規避該號碼下發。 |
isv.PARAM_LENGTH_LIMIT | 參數超過長度限制 | 原因：參數超過長度限制。 解決方案：針對2018年01月10日之后申請的短信通知類模板，變量限制為1~35個字符；驗證碼類模板，變量限制為4～6個字符，請修改參數長度。 短信模板規范詳情，請參見短信模板規范。 |
isv.PARAM_NOT_SUPPORT_URL | 變量不支持傳入URL | 原因：變量內容中含有限制發送的內容，例如變量中不允許透傳URL。 解決方案：請檢查通過變量是否透傳了URL或敏感信息。短信模板內容規范，請參見短信模板規范。 |
isv.AMOUNT_NOT_ENOUGH | 賬戶余額不足 | 原因：當前賬戶余額不足。 解決方案：
計費以及套餐包購買詳情，請參見計費概述。 |
isv.TEMPLATE_PARAMS_ILLEGAL | 傳入的變量內容和實際申請模板時變量所選擇的屬性類型不配 | 原因：例如申請模板時對phone變量，選擇變量屬性為"電話號碼"，但實際入參時對這個變量賦值非號碼類型的內容。 解決方案：針對上述原因，phone變量入參應為：5~11位的國內標準手機號或固定電話號碼，更多變量屬性規范，請參見驗證碼模板變量屬性規范或通知短信模板變量屬性規范。 |
SignatureDoesNotMatch | 客戶端生成的簽名與服務端不匹配 | 原因：簽名（Signature）加密錯誤。 解決方案：
|
InvalidTimeStamp.Expired | 時間戳或日期已過期 | 原因：一般由于時區差異造成時間戳錯誤，發出請求的時間和服務器接收到請求的時間不在15分鐘內。 解決方案：請使用GMT時間。 說明 阿里云網關使用的時間是GMT時間。 |
SignatureNonceUsed | 簽名隨機數已被使用 | 原因：唯一隨機數重復，SignatureNonce為唯一隨機數，用于防止網絡重復攻擊。 解決方案：不同請求請使用不同的隨機數值。 |
InvalidVersion | API版本號錯誤 | 原因：版本號（Version）錯誤。 解決方案：請確認接口的版本號，短信服務的API版本號（Version）為2017-05-25。 |
InvalidAction.NotFound | 未找到指定的API，請檢查您的URL和方法 | 原因：參數Action中指定的接口名錯誤。 解決方案：請在參數Action中使用正確的接口地址和接口名。 |
isv.SIGN_COUNT_OVER_LIMIT | 超過單自然日簽名申請數量上限 | 原因：一個自然日中申請簽名數量超過限制。 解決方案：合理安排每天的簽名申請數量，次日重新申請。更多信息，請參見個人用戶和企業用戶權益區別。 |
isv.TEMPLATE_COUNT_OVER_LIMIT | 超過單自然日模板申請數量上限 | 原因：一個自然日中申請模板數量超過限制。 解決方案：合理安排每天的模板申請數量，次日重新申請。更多信息，請參見個人用戶和企業用戶權益區別。 |
isv.SIGN_NAME_ILLEGAL | 簽名名稱不符合規范 | 原因：簽名名稱不符合規范。 解決方案：請重新申請簽名。簽名規范，請參見短信簽名規范。 |
isv.SIGN_FILE_LIMIT | 簽名認證材料附件大小超過限制 | 原因：簽名認證材料附件大小超過限制。 解決方案：壓縮簽名認證材料至2 MB以下。 |
isv.SIGN_OVER_LIMIT | 簽名字符數量超過限制 | 原因：簽名的名稱或申請說明的字數超過限制。 解決方案：修改簽名名稱或申請說明，并重新提交審核。簽名規范，請參見短信簽名規范。 |
isv.TEMPLATE_OVER_LIMIT | 模板字符數量超過限制 | 原因：模板的名稱、內容或申請說明的字數超過限制。 解決方案：修改模板的名稱、內容或申請說明，并重新提交審核。 |
SIGNATURE_BLACKLIST | 簽名內容涉及違規信息 | 原因：簽名內容涉及違規信息。 解決方案：重新修改簽名內容。簽名規范，請參見短信簽名規范。 |
isv.SHORTURL_OVER_LIMIT | 超過單自然日短鏈申請數量上限 | 原因：一天創建短鏈數量超過限制。 解決方案：合理預估一天申請短鏈數量，次日重新創建短鏈。 |
isv.NO_AVAILABLE_SHORT_URL | 該賬號無有效短鏈 | 原因：企業客戶當前并無有效短鏈。 解決方案：企業客戶需重新申請有效短鏈，保證在短鏈有效期內調用短參生成接口。 |
isv.SHORTURL_NAME_ILLEGAL | 短鏈名不能超過13字符 | 原因：短鏈名不能超過13個字符。 解決方案：請根據短鏈規范重新創建。 |
isv.SOURCEURL_OVER_LIMIT | 原始鏈接字符數量超過限制 | 原因：原始鏈接字符數量超過限制。 解決方案：重新創建判斷字符長度是否符合平臺規則。 |
isv.SHORTURL_TIME_ILLEGAL | 短鏈有效期期限超過限制 | 原因：選擇短鏈有效期限超過30天限制。 解決方案：請保證短鏈有效期輸入在30天以內。 |
isv.PHONENUMBERS_OVER_LIMIT | 上傳手機號個數超過上限 | 原因：單次調用上傳手機號個數超過50000個上限。 解決方案：分多次調用短參生成接口，單次上傳手機號個數不超過50000個。 |
isv.SHORTURL_STILL_AVAILABLE | 原始鏈接生成的短鏈仍在有效期內 | 原因：原始鏈接生成的短鏈仍在有效期內，無需重復創建。 解決方案：
|
isv.ERROR_EMPTY_FILE | 簽名文件為空 | 原因：簽名文件為空。 解決方案：檢查簽名文件，補充簽名資質證明、授權書等相關文件截圖。相關操作，請參見申請短信簽名。 |
isp.GATEWAY_ERROR | 調用發送應用模塊失敗 | 原因：調用發送應用模塊失敗。 解決方案：調用發送應用模塊失敗，請嘗試重新發送。 |
isv.ERROR_SIGN_NOT_DELETE | 審核中的簽名，暫時無法刪除 | 原因：簽名正在審核中，暫時無法刪除。 解決方案：請簽名審核結束后，再刪除對應簽名。 |
isv.ERROR_SIGN_NOT_MODIFY | 已通過的簽名不支持修改 | 原因：已通過的簽名不支持修改。 解決方案：請按簽名規范，重新提交申請簽名。具體操作，請參見申請短信簽名。 |
isv.ERROR_TEMPLATE_NOT_DELETE | 審核中的模板，暫時無法刪除 | 原因：模板正在審核中，暫時無法刪除。 解決方案：請模板審核結束后，再刪除對應模板。 |
isv.ERROR_TEMPLATE_NOT_MODIFY | 已通過的模板不支持修改 | 原因：已通過的模板不支持修改。 解決方案：請按模板規范，重新提交申請模板。更多信息，請參見短信模板規范。 |
isv.SMS_OVER_LIMIT | 單日最多申請模板或簽名100條 | 原因：您已超過單日最多申請模板或簽名100條的上限。 解決方案：請您24小時后繼續申請，或點擊鏈接，打開釘釘掃碼進入短信服務專屬釘群處理。 |
isv.CUSTOMER_REFUSED | 用戶已退訂推廣短信 | 原因：該手機用戶已退訂推廣短信。 解決方案：請尊重手機用戶意愿，減少對該客戶的推廣短信發送。 |
isv.SMS_TEST_SIGN_TEMPLATE_LIMIT | 測試模板和簽名限制 | 原因：測試專用簽名和模板必須結合使用。 解決方案：請使用短信服務提供的測試專用簽名和測試專用模板。相關操作，請參見發送測試短信。 |
isv.SHORTURL_DOMAIN_EMPTY | 短鏈創建失敗 | 解決方案：請先提交該鏈接的一級域名報備。 |
template_parameter_count_illegal | 驗證碼模板僅支持一個驗證碼作為變量 | 原因：在驗證碼模板變量中只能定義一個參數。 解決方案：請修改驗證碼模板變量。更多信息，請參見驗證碼模板規范。 |
isv.SMS_TEST_TEMPLATE_PARAMS_ILLEGAL | 測試專用模板中的變量僅支持4~6位純數字 | 解決方案：使用測試模板時變量僅支持傳入4~6位純數字。 |
isv.SMS_TEST_NUMBER_LIMIT | 只能向已綁定的手機號發送 | 原因：接收測試短信號碼未在控制臺綁定，或綁定過程未完成、未生效。 解決方案：
|
原因：接口調用與綁定手機號不匹配。 解決方案：請檢查在API請求或控制臺調用中指定的手機號是否與在控制臺綁定的測試手機號完全一致，包括國家碼和格式。 | ||
原因：如您在生產環境遇到此錯誤碼，請排查您是否將測試環境與生產環境混淆。 解決方案：測試簽名和模板（在控制臺顯示有綠色“測”標記）會限制發送對象僅為已綁定的測試號碼。請確保在正式發送短信時使用的是非測試的簽名和模板。 | ||
isv.SMS_SIGN_EMOJI_ILLEGAL | 簽名不能包含emoji表情 | 解決方案：簽名中不支持使用emoji表情。 |
isv.SECURITY_FROZEN_ACCOUNT | 因該賬號長時間未使用，出于對您的賬號安全考慮，已限制您賬號的短信發送 | 您若需要繼續使用該賬號，請與您的商務經理聯系。 |
IS_CLOSE | 短信下發時通道被關停 | 阿里云會自動剔除被關停通道，建議稍后重試。 |
PARAMS_ILLEGAL | 參數錯誤 | 請檢查短信簽名、短信文案或手機號碼等參數是否傳入正確。 |
MOBILE_NOT_ON_SERVICE | 停機、空號、暫停服務、關機、不在服務區 | 原因：運營商返回給阿里云平臺該號碼實時狀態異常，如關機、停機、空號、暫停服務、不在服務區等。 解決方案：請核實接收手機號碼狀態是否正常。 |
MOBILE_SEND_LIMIT | 單個號碼日、月發送上限，流控超限，頻繁發送超限 | 為了限制平臺短信被惡意調用、在短時間內大量發起短信發送請求，阿里云平臺和運營商都會有限制。 |
MOBILE_ACCOUNT_ABNORMAL | 用戶賬戶異常、攜號轉網、欠費等 | 建議檢查號碼狀態, 確保號碼狀態正常后重新嘗試。 |
MOBILE_IN_BLACK | 手機號在黑名單 | 通常為手機號在運營商平臺黑名單庫中，一般是用戶已退訂此簽名或命中運營商平臺黑名單規則導致。 |
MOBLLE_TERMINAL_ERROR | 手機終端問題、內存滿、SIM卡滿、非法設備等 | 建議核實終端設備狀況、檢查手機安全軟件攔截記錄、重啟或者更換手機終端后再次嘗試。 |
CONTENT_KEYWORD | 內容關鍵字攔截 | 原因：運營商根據短信中有潛在風險或者高投訴的內容關鍵字進行自動攔截。 解決方案：請您檢查發送的短信內容并相應修改文案。 |
INVALID_NUMBER | 號碼狀態異常 | 原因：短信接收號碼狀態異常，如關機、停機、空號、暫停服務、不在服務區或號碼格式錯誤。 解決方案：請您核實號碼狀態是否正常、號碼格式是否正確。 |
CONTENT_ERROR | 內容無退訂 | 原因：推廣短信內容中必須帶退訂信息。 解決方案：請您核實文案內容，增加退訂信息，在推廣短信結尾添加“拒收請回復R”。更多詳情請參見推廣短信模板規范。 |
REQUEST_SUCCESS | 請求成功（平臺接到請求，但未接收到運營商側的回執狀態） | 原因：大概率是由于接收用戶的狀態異常導致。 解決方案：請您檢查接收用戶狀態是否正常。 |
SP_NOT_BY_INTER_SMS | 未開通國際短信 | 原因：收件人未開通接收國際短信功能。 解決方案：聯系運營商開通國際短信功能后再進行短信發送。 |
SP_UNKNOWN_ERROR | 運營商未知錯誤 | 該錯誤碼表示阿里云平臺接收到的運營商回執報告為未知錯誤，阿里云會定期與供應商核實更新。 |
USER_REJECT | 接收用戶已退訂此業務或產品未開通 | 建議將此類接收用戶剔除出發送清單。 |
NO_ROUTE | 當前短信內容無可用通道發送 | 發送的業務場景屬于暫時無法支持的場景。 |
isv.UNSUPPORTED_CONTENT | 不支持的短信內容 | 原因：短信內容包含不支持的發送內容，如短信內容中包含繁體字、emoji表情符號、 其他非常用字符（例如【】、〖〗、『』、「」、 m2、 ? 、①、★、※、→、 、?、?）。 解決方案：檢查短信內容修改短信文案，去掉不支持的文字符號，更詳細的短信模板內容規范，請參見短信模板規范。 |
isv.SMS_CONTENT_MISMATCH_TEMPLATE_TYPE | 短信內容和模板屬性不匹配 | 原因：通知模板發送推廣、營銷的文案無法支持。 解決方案：模板請加上“拒收請回復R”然后用推廣短信的模板發送短信。 |
isv.ONE_CODE_MULTIPLE_SIGN | 一碼多簽 | 原因：當前傳入的擴展碼和簽名，與歷史傳入擴展碼對應的簽名不一致。 解決方案：建議您確保擴展碼對應的簽名在發送過程保持不變，或更新擴展碼簽名映射關系中該擴展碼對應的新簽名。 |
isv.CODE_EXCEED_LIMIT | 自拓擴展碼個數已超過上限 | 原因：自拓擴展碼數量上限為10n，n即自拓擴展位數，每個用戶的自拓擴展位數不同，超過后無法分配新的擴展碼發送新簽名。 解決方案：建議您聯系產品運營經理修改自拓擴展碼位數，或刪除擴展碼簽名映射關系中可回收的擴展碼和簽名。 |
isv.CODE_ERROR | 傳入擴展碼不可用 | 原因：傳入的自拓擴展位數超限，不可直接作為下發擴展碼使用。 解決方案：建議傳入標準位長的擴展碼。 |