错误码详情定义

AutoSDK各模块错误码统一使用4个字节的整型int32_t来表示，为了提升错误码的可读性，方便业务方定位问题错误原因，统一定义了错误码详情信息，具体如下图所示：

核心接口

错误码详情信息获取

ErrorDetail com.autonavi.gbl.util.ErrorCodeHelper.getErrorDetail(int error_code)

说明：函数详情，请复制函数名称到在线API搜索。

关键参数

com.autonavi.gbl.util.model.ErrorDetail

错误码字符串

String com.autonavi.gbl.util.model.ErrorDetail.errorCode

错误原因描述

String com.autonavi.gbl.util.model.ErrorDetail.description

问题修改建议

String com.autonavi.gbl.util.model.ErrorDetail.suggesstion

调用示例

package com.autonavi.auto.presenter;\nimport android.app.Application;\nimport com.autonavi.auto.BuildConfig;\nimport com.autonavi.auto.common.AutoConstant;\nimport com.autonavi.auto.common.CommonUtil;\nimport com.autonavi.auto.common.RestPlatformInterface;\nimport com.autonavi.auto.common.TBTResReaderImpl;\nimport com.autonavi.auto.utils.AssetUtils;\nimport com.autonavi.auto.utils.FileUtils;\nimport com.autonavi.auto.utils.SpUtils;\nimport com.autonavi.gbl.common.model.TbtCommonControl;\nimport com.autonavi.gbl.common.model.UserConfig;\nimport com.autonavi.gbl.common.model.WorkPath;\nimport com.autonavi.gbl.servicemanager.ServiceMgr;\nimport com.autonavi.gbl.servicemanager.model.ALCGroup;\nimport com.autonavi.gbl.servicemanager.model.ALCLogLevel;\nimport com.autonavi.gbl.servicemanager.model.BLInitParam;\nimport com.autonavi.gbl.servicemanager.model.BaseInitParam;\nimport com.autonavi.gbl.util.model.ErrorCode;\nimport com.autonavi.gbl.util.ErrorCodeHelper;\n\nimport java.io.File;\n\n\npublic class InitConfigPresenter {\n\n    //加载引擎\n    static {\n        System.loadLibrary("GSQuirrel");\n        System.loadLibrary("third_party_libs");\n        System.loadLibrary("GPlatformInterface");\n        System.loadLibrary("AutoCrypto");\n        System.loadLibrary("AutoSSL");\n        System.loadLibrary("GComm3rd");\n        System.loadLibrary("mqtt");\n        System.loadLibrary("GNet"); // 网络库\n        System.loadLibrary("GNaviDice"); //引擎\n        System.loadLibrary("Gbl");//bl\n    }\n\n    private Application mContext;\n    private boolean async = false;//true为异步log、false为同步log\n\n    private int baseLibInitResultCode = ErrorCode.AUTO_UNKNOWN_ERROR; // baseLib初始化结果\n    private int initBLResultCode = ErrorCode.AUTO_UNKNOWN_ERROR; // bl初始化结果\n\n    public InitConfigPresenter(Application context) {\n        mContext = context;\n        //拷贝资源文件等\n        // ...\n        initBL();\n    }\n    \n    /**\n     * 初始化BL\n     */\n    public int initBL() {\n        BLInitParam blInitParam = new BLInitParam();\n        //配置文件路径\n        blInitParam.dataPath.cfgFilePath = AutoConstant.PATH;\n        //离线地图\n        blInitParam.dataPath.offlinePath = AutoConstant.PATH + "data/navi/compile_v2/chn/";   // navi\n        //精品三维地图\n        blInitParam.dataPath.off3DDataPath = AutoConstant.PATH + "data/navi/compile_v2/chn/"; //\n        //云加端存放路径\n        blInitParam.dataPath.onlinePath = AutoConstant.PATH + "online/";\n\n        FileUtils.createDIR(blInitParam.dataPath.offlinePath);\n        FileUtils.createDIR(blInitParam.dataPath.onlinePath);\n\n        initBLResultCode = ServiceMgr.getServiceMgrInstance().initBL(blInitParam, mContext);\n\n        if (initBLResultCode != ErrorCode.ErrorCodeOK) {\n            // initBL失败,获取错误码详情\n            ErrorDetail detail = ErrorCodeHelper.getErrorDetail(initBLResultCode);\n            Log.i(TAG, " errorCode = " + detail.errorCode);\n            Log.i(TAG, " description = " + detail.description);\n            Log.i(TAG, " suggesstion = " + detail.suggesstion);\n        }\n        return initBLResultCode;\n    }\n}\n

典型错误码详情表

错误码	错误描述	修改建议
errorcode.common.Service.ErrorCodeOK	操作成功	操作成功
errorcode.common.Service.ErrorCodeFailed	操作失败	操作失败
errorcode.common.Service.ErrorCodeDoing	操作进行中	请稍后重试操作
errorcode.common.Service.ErrorCodeNotInit	未初始化	请先初始化
errorcode.common.Service.ErrorCodeInvalidParam	无效参数	请检查API入参
errorcode.common.Service.ErrorCodeFileNoExist	文件不存在	请检查文件是否存在
errorcode.common.Service.ErrorCodePathNoExist	路径不存在	请创建路径后重试
errorcode.common.Service.ErrorCodeVerify	校验错误	文件校验码验证错误，请确认文件是否非法
errorcode.common.System.ErrorCodeOpenfile	打开文件失败	请检查文件是否存在
errorcode.common.System.ErrorCodeReadfile	读取文件失败	请检查文件是否有读取权限
errorcode.common.System.ErrorCodeRenamefile	重命名文件失败	请检查文件是否有写入权限
errorcode.common.System.ErrorCodeWritefile	写文件失败	请检查文件是否有写入权限
errorcode.common.ThirdParty.ErrorCodeNetCancel	取消网络操作	请确认用户是否取消了网络请求操作
errorcode.common.ThirdParty.ErrorCodeNetFailed	网络错误	请确认机器是否可以联网,网络ping状态延时是否正常
errorcode.common.ThirdParty.ErrorCodeNetUnreach	无网络	请确认机器是否可以联网
errorcode.user.Common.ErrorCodeNotLogin	未登陆	请先登陆再重试操作
errorcode.search.Online.ErrorCodeOnlineNoData	(在线转离线)本地没有离线数据	请确认本地是否有离线数据
errorcode.search.Online.ErrorCodeOnlineToOfflineNoData	(在线转离线)离线数据无结果	请更换关键字搜索试试
errorcode.Activation.ErrorCodeCheckCode	激活码验证失败	请确认激活码是否有效
errorcode.Activation.ErrorCodeInputDeviceId	设备ID输入有误	请确认设备ID是否有效
errorcode.Activation.ErrorCodeNetActiveOverActivation	网络激活超过激活次数，一个硬件码至多激活三次	一个硬件码至多激活三次，请更换合法的激活码后重试
errorcode.Ar.AROfflineErrorRecordCreateFileFail	AR录制：创建文件失败	请注意数据目录下的子目录ardata目录是否有可写权限
errorcode.Ar.AROfflineErrorPlayIsPlaying	AR回放：已经在回放中,又调用了一次回放	请勿重复操作IAROfflineService::StartPlaying
errorcode.Route.ErrorCodeStartPointError	起点不在支持范围内	请检查算路起点经纬度是否正确
errorcode.Route.ErrorCodeEndPointError	终点不在支持范围内	请检查终点经纬度是否正确
errorcode.Route.ErrorCodeLackStartCityData	起点所在城市无数据	请检查是否下载了起点所在城市的本地离线数据
errorcode.Guide.ErrorCodeContinueGuideNotEnable	续航功能未开启	未开启续航功能，请检查GuideService::SetParam传入的续航设置参数
errorcode.Guide.ErrorCodeContinueGuideInvalidParam	输入的续航数据错误，不满足写入条件	请检查GuideService::SetPathData传入的路线buffer数据是否正确
errorcode.Guide.ErrorCodeContinueGuideDecodeFail	解码续航路线二进制错误	请检查GuideService::SetPathData传入的路线buffer数据是否正确
errorcode.Pos.ErrorCodeParallelSwitchTypeError	平行路切换类型类型	请检查切换平行路接口传入的切换类型是否正确
errorcode.Pos.ErrorCodeParallelSwitchLackParallelRoadInfo	当前缺少平行路信息，不能进行平行路切换	当前不存在主辅路，不可进行切换动作
errorcode.Pos.ErrorCodeParallelSwitchNullPointer	内部空指针导致切换主辅路失	请联系AutoSDK

替换说明

Java接口

1、服务管理

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

2、主图：

com.autonavi.gbl.util.model.EGErr替换为com.autonavi.gbl.util.errorcode.common下枚举

3、图层：

com.autonavi.gbl.map.layer.model.LayerTextureErrorCode替换为com.autonavi.gbl.util.errorcode.Layer

com.autonavi.gbl.layer.model.BizTempErrorCode替换为com.autonavi.gbl.util.errorcode.Layer

4、TBT：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

com.autonavi.gbl.common.model.RouteErrorcode替换为com.autonavi.gbl.util.errorcode.Route

com.autonavi.gbl.tbtmodule.model.ContinueGuideErrorCode替换为com.autonavi.gbl.util.errorcode.Guide

com.autonavi.gbl.tbtmodule.model.ParallelRoadSwitchErrorCode替换为com.autonavi.gbl.util.errorcode.Pos

com.autonavi.gbl.tbtmodule.model.CalcRouteError替换为com.autonavi.gbl.util.errorcode.Route

5、用户模块：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common、com.autonavi.gbl.util.errorcode.user下枚举

6、数据模块：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common、com.autonavi.gbl.util.errorcode.data下枚举

com.autonavi.gbl.data.model.OperationErrCode替换为com.autonavi.gbl.util.errorcode.common、com.autonavi.gbl.util.errorcode.data下枚举

7、搜索模块：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

com.autonavi.gbl.util.model.EGErr替换为com.autonavi.gbl.util.errorcode.common、com.autonavi.gbl.util.errorcode.search下枚举

8、AOS模块：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

com.autonavi.gbl.aosclient.model.EGHTTPCLIENTSTATUS替换为com.autonavi.gbl.util.errorcode.common下枚举

9、AR模块：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

com.autonavi.gbl.ar.model.AROfflineError替换为com.autonavi.gbl.util.errorcode.Ar

10、地理围栏：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

11、激活模块：

com.autonavi.gbl.activation.model.ActivateErrorCode替换为com.autonavi.gbl.util.errorcode.Activation

12、TTS模块：

com.autonavi.gbl.util.model.ErrorCode替换为 com.autonavi.gbl.util.errorcode.common下枚举

C++接口

1、服务管理

bl::ErrorCode替换为bl::errorcode::common

2、主图：

bl::EGErr替换为bl::errorcode::common、bl::SceneErrorCode替换为bl::errorcode::multi::Scene

3、图层：

bl::LayerTextureErrorCode替换为bl::errorcode::Layer
bl::BizTempErrorCode替换为bl::errorcode::common、bl::errorcode::Layer

4、TBT

bl::ErrorCode替换为bl::errorcode::common
bl::RouteErrorcode 替换为bl::errorcode::Route
bl::ContinueGuideErrorCode 替换为bl::errorcode::Guide
bl::ParallelRoadSwitchErrorCode替换为bl::errorcode::Pos
bl::CalcRouteError 替换为bl::errorcode::Route

5、用户模块

bl::ErrorCode替换为bl::errorcode::common、bl::errorcode::user

6、数据模块

bl::ErrorCode替换为bl::errorcode::common、bl::errorcode::data
bl::OperationErrCode替换为bl::errorcode::common、bl::errorcode::data

7、搜索模块

bl::ErrorCode替换为bl::errorcode::common
bl::EGErr替换为bl::errorcode::common、bl::errorcode::search

8、AOS模块

bl::ErrorCode替换为bl::errorcode::common
EGHTTPCLIENTSTATUS 替换为bl::errorcode::common

9、AR模块

bl::ErrorCode替换为bl::errorcode::common
bl::AROfflineError替换为bl::errorcode::common

10、地理围栏

bl::ErrorCode替换为bl::errorcode::common

11、激活模块

bl::ActivateErrorCode替换为bl::errorcode::common、bl::errorcode::Activation

12、TTS模块

bl::ErrorCode替换为bl::errorcode::common