移动推送的错误码列表_移动研发平台(EMAS)-阿里云帮助中心

本文介绍移动推送的错误码列表供您参考。

调用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	已经调用注册，重复调用无效	register方法如果失败了，会自动重试，一般情况下不需要重复调用。如果希望内部重试失败的情况，由外部重新调用register，请至少在上一次register失败回调两次（确认内部重试还是失败）的情况下，先调用PushControlService的reset方法，然后再调用下一次register方法。
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	移除别名失败，本地没有别名记录	请检查输入的别名是否正确。低版本推送有概率出现，添加别名后，应用的数据被清除，导致SDK内部存储的别名信息丢失，无法移除。
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_ACCS_123, 123为推送底层通道错误码，请结合推送底层通道错误码排查。
EAGOO_SERVER_XXX	服务错误信息	推送服务报错，请联系技术支持排查。格式EAGOO_SERVER_XXX, 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

错误码 （V3.7.6版本及以上）

常见错误码 （V2.3.5版本及以上）

常见错误码（V2.3.4版本及以下）

错误码（V3.7.6版本及以上）

常见错误码（V2.3.5版本及以上）