本文介紹移動推送的錯誤碼列表供您參考。
調用CloudPushService的相關接口時，如果發生錯誤，可以在CommonCallback的onFailed()回調中可以獲取到errorCode和errorMessage。
錯誤碼 （V3.7.6版本及以上）
推送接口層錯誤碼
錯誤碼 | 錯誤描述 | 備注 |
|---|---|---|
PUSH_00000 | success | - |
PUSH_10101 | 參數缺失 | 請檢查請求參數是否正確。 |
PUSH_10102 | 參數無效 | 請檢查請求參數是否正確。 |
PUSH_10103 | 服務端簽名與客戶端不匹配 | 請檢查推送配置是否正確。 |
PUSH_10104 | Tag相關錯誤 | 請根據具體錯誤信息排查，如果不能解決，請聯系阿里云技術支持。 |
PUSH_10105 | Alias相關錯誤 | 請根據具體錯誤信息排查，如果不能解決，請聯系阿里云技術支持。 |
PUSH_10106 | 服務端內部錯誤 | 請根據具體錯誤信息聯系阿里云技術支持。 |
PUSH_10107 | 網絡IO錯誤 |
|
PUSH_10108 | 返回結果解析錯誤 | 請保留具體錯誤信息，聯系阿里云技術支持排查。 |
PUSH_10109 | 網絡連接失敗,請檢查網絡配置 | 請檢查網絡是否可用。 |
PUSH_10114 | 內部錯誤 | 請保留具體錯誤信息，聯系阿里云技術支持排查。 |
PUSH_10115 | 通道注冊狀態異常 | 請保留具體錯誤信息，聯系阿里云技術支持排查。 |
PUSH_10118 | 其它接口錯誤 | 請根據具體錯誤信息聯系阿里云技術支持。 |
PUSH_10119 | 非主進程不用初始化 | 在非主進程執行初始化時觸發，可以忽略。 |
PUSH_10120 | 推送注冊超時 | 請保留具體錯誤信息，聯系阿里云技術支持排查。 |
PUSH_10121 | 網絡請求失敗，請檢查網絡是否可用 |
|
PUSH_20101 | 參數輸入非法 | 請檢查請求的輸入參數是否正確。 |
PUSH_20102 | 靜默連接進程名設置錯誤,進程名不能為空且必須與manifest文件配置相符。系統自動設置為manifest所配置進程名 | 開啟debug會檢查此錯誤，目前進程名不支持修改，請不要修改組件進程配置。 |
PUSH_20103 | appversion參數錯誤,請檢查您的版本號,版本號不能為null或長度不能超過32位 | 開啟debug會檢查此錯誤，請檢查應用版本號是否過長。 |
PUSH_20105 | ChannelService未設置輔助進程 | 開啟debug會檢查此錯誤，如果不是特殊場景，請檢查是否修改了推送組件的進程配置。 |
PUSH_20106 | 核心組件未配置 | 開啟debug會檢查此錯誤，請檢查是否刪除了推送組件的聲明。 |
PUSH_20107 | 連續crash，推送服務關閉 |
|
PUSH_20108 | 未初始化，請先調用 PushServiceFactory的init方法 | 請確認是否正常初始化。 |
PUSH_20109 | 廢棄接口 | 請查看CHANP文檔，使用合適的API。 |
PUSH_20110 | 已經調用注冊，重復調用無效 |
|
PUSH_ACCS_123 | accs錯誤信息 | 格式ACCS_123, 123為accs錯誤碼，請結合accs錯誤碼排查。 |
PUSH_xxx | agoo錯誤信息 | 格式AGOO_xxx, xxx為agoo錯誤碼，請結合agoo錯誤碼排查。 |
推送協議層（AGOO）錯誤碼
錯誤碼 | 錯誤描述 | 備注 |
|---|---|---|
EAGOO_SDK_success | success | - |
EAGOO_SDK_remove_alias_fail_no_token | 移除別名失敗，本地沒有別名記錄 |
|
EAGOO_SDK_remove_alias_fail_no_alias | 移除別名失敗，本地沒有別名記錄 | 請檢查輸入的別名是否正確2. 低版本推送有概率出現，添加別名后，應用的數據被清除，導致SDK內部存儲的別名信息丟失，無法移除 |
EAGOO_SDK_invalid_arg | 請求參數錯誤 | 請檢查輸入參數。 |
EAGOO_SDK_accs_disabled | accs檢查不通過 |
|
EAGOO_SDK_agoo_not_bind | 請先注冊初始化agoo | 請檢查初始化是否成功。 |
EAGOO_ACCS_123 | accs 錯誤信息 |
|
EAGOO_SERVER_XXX | 服務錯誤信息 |
|
推送底層通道（ACCS）錯誤碼
錯誤碼 | 錯誤描述 | 備注 |
|---|---|---|
200 | 成功 | - |
300 | 通道未建立 | 請先初始化bindApp，再調用其它API。 |
-1 | 靜默連接中斷，無法發送消息 | 內部會重試，如果一直失敗，需要排查下靜默通道是否正常。 |
-2 | 參數錯誤,發送的msg為null | 請檢查發起請求的參數是否正確。 |
-3 | 服務返回數據異常 | 請關注錯誤信息中的服務返回數據，并聯系阿里云技術支持同學確認原因。 |
-4 | 單次發送數據過大 | 請減少一次發送的數據量，封裝之后總的數據量要小于16KB。 |
-5 | 發送服務地址為null | 請檢查下初始化配置是否正確 |
-6 | 靜默通道長連接認證參數錯誤 | 請檢查初始化參數配置是否正確 |
-7 | 靜默通道長連接認證異常 | 請查看錯誤信息，確認具體異常信息。 |
-8 | 發送數據異常 | 請查看錯誤信息，確認具體異常信息。 |
-9 | 發送消息超時 | 需要結合具體是查看為什么超時。 |
-10 | 靜默通道長連接斷連 | 斷連需要查看之前的日志。 |
-11 | 應用內長連接斷開 | 一般為長連接建連失敗造成，需要看日志分析。 |
-12 | 靜默通道長連接ping超時 | - |
-13 | 無網絡 | 請檢查網絡連接。 |
-14 | appKey不存在 | 請檢查初始化配置是否正確。 |
-15 | appSecret不存在 | 請檢查初始化配置是否正確。 |
70008 | 長連接發送隊列已滿 | 請確認是否有高并發發送消息，如果有，請限制發送頻次。 |
70020 | 低級別限流 | 請和部署同學確認限流策略。 |
70021 | 高級別限流,不發送 | 請和部署同學確認限流策略。 |
70023 | 防刷解封后觸發的限流，不發送 | 請和部署同學確認限流策略。 |
102 | 設備無效 | 如果是測試時發現的，請清除應用數據重新嘗試。 |
302 | 設備無效 | 如果是測試時發現的，請清除應用數據重新嘗試。 |
303 | appkey配置錯誤 | 請檢查AppKey配置是否正確。 |
304 | 包名錯誤 | 請檢查appKey和應用包名是否匹配。 |
-20 | 服務返回錯誤 | 請關注下錯誤信息中的服務返回的錯誤碼，并聯系阿里云技術支持同學確認原因。 |
-22 | 底層sdk連接關閉 | 請關注下錯誤信息中的底層sdk返回的錯誤信息，并聯系阿里云技術支持同學確認原因。 |
-23 | 發送數據返回錯誤 | 請關注下錯誤信息中的底層sdk返回的錯誤信息，并聯系阿里云技術支持同學確認原因。 |
-25 | 不應該發生的錯誤 | 請關注下錯誤信息，檢查初始化是否存在錯誤。 |
-26 | 建連參數錯誤 | 請檢查初始化配置是否正確。 |
-27 | 建連超時 |
|
-28 | 建連失敗 |
|
-29 | 連接地址不存在 | 1. 當前網絡下無法解析長鏈接地址2. 請檢查網絡是否正常。 |
-30 | 建連異常 | 請查看具體錯誤信息排查。 |
-10000 | 底層網絡庫信息 | 小于-10000時，加上10000是底層網絡庫對應的錯誤碼，請接口底層網絡庫錯誤碼信息排查。 |
常見錯誤碼 （V2.3.5版本及以上）
錯誤名稱 | 錯誤碼（Error Code） | 錯誤描述和解決辦法（Error Message） |
|---|---|---|
MISSING_PARAM | 10101 | 參數缺失，根據詳細錯誤信息補充參數。 |
INVALID_PARAM | 10102 | 參數無效，查看詳細錯誤信息。 |
SIGN_NOT_MATCH | 10103 | 服務端與客戶端簽名不匹配，檢查AppKey，AppSecret。 |
TAG_ERROR | 10104 | Tag請求相關錯誤，查看詳細錯誤信息。 |
ALIAS_ERROR | 10105 | Alias相關錯誤，查看詳細錯誤信息。 |
INTERNAL_ERROR | 10106 | 服務端內部錯誤。 |
IO_ERROR | 10107 | 網絡I/O錯誤。 |
RESPONSE_PARSE_ERROR | 10108 | 返回結果解析錯誤。 |
CONNECTION_FAIL | 10109 | 網絡連接失敗,請檢查網絡配置。 |
SYSTEM_ERROR | 10110 | 系統錯誤。 |
UNKNOWN_ERROR | 10111 | 未知錯誤。 |
NO_NETWORK | 10201 | 網絡不可用 |
APPKEY_NULL | 10202 | 無效AppKey。 |
APPSECRET_NULL | 10203 | 無效AppSecret。 |
APPRECEIVER_NULL | 10204 | 回調函數為空。 |
REG_TIME_OUT | 10205 | 請求超時，請查看tag為awcn的error級別日志。 |
CONN_INVALID | 10206 | 當前連接異常。 |
NO_CONNECTION | 10207 | 無網絡連接,請查看tag為awcn的error級別日志。建議檢查一下相應so包是否添加，可參考出現“1105，網絡不穩定或連接異常錯誤”怎么解決？ |
TAIR_ERROR | 10209 | 服務器錯誤。 |
INVALID_DEVICEID | 10210 | 無效deviceid。 |
INVALID_PACKAGE | 10211 | 包名與配置不符。 |
ACCS_CHANNEL_INIT_FAIL | 10212 | 靜默連接進程（默認為channel進程）未初始化，參考Android推送失敗排查步驟中“已經接入成功，突然出現異常”下第二小節。 |
API_INVALID_INPUT | 20101 | 參數非法，詳見具體錯誤信息。 |
APP_VERSION_INVALID | 20103 | appversion參數錯誤,請檢查您的版本號,版本號不能為null且長度不能超過32位。 |
CHANNEL_PROCESS_NULL | 20105 | ChannelService未設置輔助進程。 |
REQUIRED_COMPONENT_NOT_EXISTS | 20106 | 核心組件未配置，詳見具體錯誤信息。 |
CONTINOUS_CRASH | 20107 | 連續crash，推送服務關閉。 |
常見錯誤碼（V2.3.4版本及以下）
錯誤名稱 | 錯誤碼（Error Code） |
|---|---|
NO_NETWORK | 1101 |
REG_FAIL | 1056 |
INVAILD_APPKEY | 1052 |
INVAILD_PACKAGENAME | 1053 |
INVAILD_APPSECRET | 1054 |
NETWORK_UNSTABLE | 1105 |
INVAILD_SERVER_RETRUN | 1115 |
SYSTEM_UNKNOWN_ERROR | 1108 |