本文介绍移动推送 Android SDK 3.x 的错误码,并保留历史 2.x 错误码供维护旧应用时参考;不适用于 4.x。
本文错误码、ACCS/SPDY 处理建议和 awcn 等日志过滤方式均适用于低于 4.0.0 的旧版本。4.x 使用 ACCS 自有通道和 EMAS_PUSH 统一日志 TAG,请按错误处理(4.x)排查对应版本的 API 回调错误和连接问题。
调用 CloudPushService 接口发生错误时,可通过 CommonCallback 的 onFailed() 回调获取 errorCode 和 errorMessage。
错误码(V3.7.6 及以上、低于 V4.0.0)
-
推送接口层错误码
|
错误码 |
错误描述 |
备注 |
|---|---|---|
|
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 后,SDK 会检查组件进程配置。当前版本不支持修改进程名,请保留默认组件进程配置。 |
|
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 |
移除别名失败,本地没有别名记录 |
请检查输入的别名是否正确。部分低版本 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 |
静默连接中断,无法发送消息 |
SDK 会自动重试。持续失败时,请检查静默通道是否正常。 |
|
-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 |
非预期错误 |
请记录完整错误信息,并检查 SDK 初始化配置。 |
|
-26 |
建连参数错误 |
请检查初始化配置是否正确。 |
|
-27 |
建连超时 |
|
|
-28 |
建连失败 |
|
|
-29 |
连接地址不存在 |
1. 当前网络下无法解析长链接地址2. 请检查网络是否正常。 |
|
-30 |
建连异常 |
请查看具体错误信息排查。 |
|
-10000 |
底层网络库信息 |
小于-10000时,加上10000是底层网络库对应的错误码,请结合底层网络库错误码信息排查。 |
历史常见错误码(V2.3.5 及以上、低于 V4.0.0)
|
错误名称 |
错误码(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 |
请求超时。3.x 及相应旧版本请查看 TAG 为 awcn 的 error 级别日志。 |
|
CONN_INVALID |
10206 |
当前连接异常。 |
|
NO_CONNECTION |
10207 |
无网络连接。3.x 及相应旧版本请查看 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 |