错误处理

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

调用CloudPushService的相关接口时,如果发生错误,可以在CommonCallbackonFailed()回调中可以获取到errorCodeerrorMessage

错误码 (V3.7.6版本及以上)

  • 推送接口层错误码

错误码

错误描述

备注

PUSH_00000

success

-

PUSH_10101

参数缺失

请检查请求参数是否正确。

PUSH_10102

参数无效

请检查请求参数是否正确。

PUSH_10103

服务端签名与客户端不匹配

请检查推送配置是否正确。

PUSH_10104

Tag相关错误

请根据具体错误信息排查,如果不能解决,请联系阿里云技术支持。

PUSH_10105

Alias相关错误

请根据具体错误信息排查,如果不能解决,请联系阿里云技术支持。

PUSH_10106

服务端内部错误

请根据具体错误信息联系阿里云技术支持。

PUSH_10107

网络IO错误

  1. 请检查网络是否可用

  2. 请根据具体错误信息排查,如果不能解决,请联系阿里云技术支持。

PUSH_10108

返回结果解析错误

请保留具体错误信息,联系阿里云技术支持排查。

PUSH_10109

网络连接失败,请检查网络配置

请检查网络是否可用。

PUSH_10114

内部错误

请保留具体错误信息,联系阿里云技术支持排查。

PUSH_10115

通道注册状态异常

请保留具体错误信息,联系阿里云技术支持排查。

PUSH_10118

其它接口错误

请根据具体错误信息联系阿里云技术支持。

PUSH_10119

非主进程不用初始化

在非主进程执行初始化时触发,可以忽略。

PUSH_10120

推送注册超时

请保留具体错误信息,联系阿里云技术支持排查。

PUSH_10121

网络请求失败,请检查网络是否可用

  1. 请检查网络是否可用。

  2. 请根据具体错误信息排查,如果不能解决,请联系阿里云技术支持。

PUSH_20101

参数输入非法

请检查请求的输入参数是否正确。

PUSH_20102

静默连接进程名设置错误,进程名不能为空且必须与manifest文件配置相符。系统自动设置为manifest所配置进程名

开启debug会检查此错误,目前进程名不支持修改,请不要修改组件进程配置。

PUSH_20103

appversion参数错误,请检查您的版本号,版本号不能为null或长度不能超过32位

开启debug会检查此错误,请检查应用版本号是否过长。

PUSH_20105

ChannelService未设置辅助进程

开启debug会检查此错误,如果不是特殊场景,请检查是否修改了推送组件的进程配置。

PUSH_20106

核心组件未配置

开启debug会检查此错误,请检查是否删除了推送组件的声明。

PUSH_20107

连续crash,推送服务关闭

  1. 应用初始化推送后崩溃,会在下次启动关闭推送服务。请检查应用的崩溃记录。

  2. 开发测试场景下,人为触发的,请清除应用数据恢复。

  3. 线上场景会尝试自动恢复,如果仍然崩溃,需要升级应用版本才会恢复。

PUSH_20108

未初始化,请先调用 PushServiceFactory的init方法

请确认是否正常初始化。

PUSH_20109

废弃接口

请查看CHANP文档,使用合适的API。

PUSH_20110

已经调用注册,重复调用无效

  1. register方法如果失败了,会自动重试,一般情况下不需要重复调用。

  2. 如果希望内部重试失败的情况,由外部重新调用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

移除别名失败,本地没有别名记录

  1. 请检查输入的别名是否正确。

  2. 低版本推送有概率出现,添加别名后,应用的数据被清除,导致sdk内部存储的别名信息丢失,无法移除。

EAGOO_SDK_remove_alias_fail_no_alias

移除别名失败,本地没有别名记录

请检查输入的别名是否正确2. 低版本推送有概率出现,添加别名后,应用的数据被清除,导致sdk内部存储的别名信息丢失,无法移除

EAGOO_SDK_invalid_arg

请求参数错误

请检查输入参数。

EAGOO_SDK_accs_disabled

accs检查不通过

  1. 请检查初始化是否成功。

  2. 请检查配置是否正确。

  3. 请检查请求是否是在主进程。

EAGOO_SDK_agoo_not_bind

请先注册初始化agoo

请检查初始化是否成功。

EAGOO_ACCS_123

accs 错误信息

  1. 推送底层通道错误,需要根据错误码排查。

  2. 格式EAGOO_ACCS_123, 123为推送底层通道错误码,请结合推送底层通道错误码排查。

EAGOO_SERVER_XXX

服务错误信息

  1. 推送 服务报错,请联系技术支持排查。

  2. 格式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

建连超时

  1. 请查看具体错误信息排查。

  2. 请检查网络是否正常。

-28

建连失败

  1. 请查看具体错误信息排查。

  2. 请检查网络是否正常。

-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

阿里云首页 移动推送 相关技术圈