全局错误码
"0"为成功,"1"为持续进行中,如下载进度持续报告,安全键盘每次输入都回调,会有多次调用,前端在此状态不会删除回调方法,既不是"0"也不是"1",的返回码认为是失败,具体失败返回码定义如下面枚举列表。
错误码枚举
失败返回码共5位:前两位表示某模块,后三位为功能使用,相同功能的错误码写在一起,如二维码的保持在一起,定位的保持在一起
框架层错误码开头为5以下(不包括5)数字开头,功能模块错误码使用5以上(包括5),例如:
模块名称 | code组成 |
桥接 | “10” + “XXX” |
WebView | “11” + “XXX” |
网络请求 | “50” + “XXX” |
定位 | “51” + “XXX” |
权限 | “52” + “XXX” |
相机 | “53” + “XXX” |
相册 | “54” + “XXX” |
指纹识别 | “55” + “XXX” |
LocalStorage | “56” + “XXX” |
本地推送消息 | “57” + “XXX” |
Application应用 | “58” + “XXX” |
OCR | “59” + “XXX” |
文件下载 | “60” + “XXX” |
文件IO | “61” + “XXX” |
二代证和活体 | “62” + “XXX” |
安全键盘 | “63” + “XXX” |
分享 | “64” + “XXX” |
图片 | “65” + “XXX” |
文件上传 | “66” + “XXX” |
文件解压缩 | “67” + “XXX” |
扫码 | “68” + “XXX” |
屏幕 | “70” + “XXX” |
通讯录 | “71” + “XXX” |
页面窗体 | “72” + “XXX” |
系统基本信息 | “73” + “XXX” |
语音 | “74” + “XXX” |
用呗 | “75” + “XXX” |
手势管理 | “76” + “XXX” |
加密解密 | “77” + “XXX” |
原生路由 | “78” + “XXX” |
音频 | “79” + “XXX” |
码表
模块名 | 错误码 | 错误描述 | 说明 |
| 0 | 成功 | |
| 1 | 持续中,常见于事件监听回调返回 | |
桥接 | 10001 | 调用模块失败 | classname异常 |
| 10002 | 调用方法失败 | action失败 |
| 10003 | 调用参数不合法 | data异常,data本身异常,不包括内层数据异常。如data参数类型不对 |
| 10004 | 调用返回数据无法解析 | payload返回值非标准JSON格式 |
| 10005 | 当前环境无法调用桥接层 | Android是因为window.FOX_NATIVE_CALL 不存在iOS是无法访问https://wvjb_queue_message/?xxx |
| 10006 | 操作取消 | 例如点击拍照,唤起拍照界面后点击取消或返回但未拍照,actionsheet取消。和其他用户取消行为 |
| 10007 | 未设置回调函数 | |
WebView | 11000 | webview截图图片路径错误 | 图片路径不是合法的或者是没有写入权限,写入指定路径数据 |
| 11003 | webview参数错误 | 参数格式,参数类型,参数名称等错误 |
| 11004 | webview必传参数为空 | 必传参数为空 |
| 11005 | webview不存在 | |
| 11006 | webview无法关闭 | webview为根视图(即第一级的视图)时无法关闭。 |
| 11007 | 移除监听失败,事件名和回调不一致 | 页面通讯的off时,事件名和回调不一致失败 |
网络请求 | 50001 | 网络请求参数异常 | 网络请求参数异常网络请求的参数传值有问题 |
| 50002 | 工作密钥为空 | 当设置需要加密,且不是协商工作密钥接口。报此错误 |
| 50003 | 无法对空的请求参数加密 | 当isEncrypt为"1",且参数传空时发生。代表想要对报文体加密,但是报文体参数为空 |
| 50400 | CONNECT ERROR | 网络连接出错/网络错误 (非http状态码) |
| 50408 | TIME OUT | 超时 (非http状态码) |
| 50404 | UNKNOW ERROR | 其它未知错误,可能返回更详细信息 (非http状态码) |
| 50417 | PARSE ERROR | 解析出错 |
定位 | 51000 | 无定位权限 | 定位权限未开启 |
| 51002 | 定位错误 | 定位错误 |
| 51003 | 定位取消 | 定位取消,单次定位的异常返回信息 |
| 51005 | 参数错误 | 参数错误 |
| 51006 | 未设置定位监听 | 尚未设置定位监听 |
| 51007 | 必传参数为空 | |
权限 | 52001 | 用户未获取相机权限 | 相机权限未授权 |
| 52002 | 用户未获取相册权限 | 相册权限未授权 |
| 52003 | 电话权限未授予 | 电话权限未授予 |
| 52004 | 存储设备读写权限未授予 | |
相机 | 53001 | 拍照或录制视频失败 | |
| 53002 | 参数错误 | 传参不合法 |
| 53003 | 参数为空 | |
指纹识别 | 55001 | 指纹信息变更/面容信息变更 | |
| 55002 | 设备不支持指纹识别/设备不支持面容识别 | |
| 55003 | 系统取消授权 | |
| 55005 | 授权失败 | |
| 55006 | 系统未设置密码 | |
| 55007 | Touch ID(FaceID) 不可用 | |
| 55008 | Touch ID(FaceID) 未注册 | |
| 55009 | 用户选择输入密码 | |
| 55010 | 其他错误信息 | |
| 55011 | 更新指纹(面容)失败 | |
| 55012 | 指纹(面容)识别已被锁定 | |
LocalStorage | 56000 | 参数为空 | 必传参数为空 |
| 56001 | 参数类型不支持 | 需要存储数据类型不是支持的数据类型 |
| 56003 | 操作失败 | 操作失败 |
本地推送消息 | 57000 | 参数为空 | 必传参数为空 |
| 57001 | 参数错误 | 参数格式,参数类型等错误 |
| 57002 | 消息不存在 | remove接口传入的notificationId 找不到对应的消息(根据bug2106建议增加的code) |
| 57003 | 绑定别名失败 | |
| 57004 | 删除别名失败 | |
Application应用 | 58002 | 必要参数为空 | |
| 58003 | 在线文档url地址错误 | 在线文档url地址不符合规范 |
| 58004 | 未找到本地文件资源 | 打开本地文件文件路径错误 |
| 58005 | 参数错误 | 例如截图所传目标路径 |
| 58006 | 截图图片路径错误 | 图片路径不是合法的或者是没有写入权限,写入指定路径数据 |
| 58007 | 截图图片格式错误 | 不是以.png 或则.jpg结尾 |
| 58008 | webview不可见无法截图 | 有可能webview不在前端显示,或则还未加载到窗体上,滚动中途webview切换到后台等情况 |
| 58009 | url加载失败 | 截图时重新url加载失败 |
| 58010 | 内核加载失败导致不能正常截图 | android使用的x5内核,当x5内核加载失败时候无法截图 |
OCR | 59000 | 参数为空 | 必传参数为空 |
| 59001 | 参数错误 | 参数格式,参数类型等错误 |
| 59002 | 不支持的操作类型 | OCRRecognizeType参数传入了非法值,传入的识别类型不是支持的类型 |
| 59003 | 识别出错 | |
| 59004 | 初始化失败 | ocr初始化的时候需要正确ak 和sk 可能由于帐号商用未续费或则帐号注销 等百度平台原因会导致ocr初始化失败。 |
文件下载 | 60001 | 参数错误 | 传参不合法 |
| 60002 | 必传参数为空 | 传参不合法 |
| 60010 | 下载任务已经不存在 | 任务不存在,对不存在的任务操作 |
| 60011 | 下载异常 | |
| 60012 | 任务不是可下载状态,不能开始下载。 | state=-1001 只有此种状态,任务才能开始 |
| 60013 | 任务不是下载中,不能暂停 | 只有任务开始下载,才能暂停 |
| 60014 | 任务不是暂停状态,不能恢复下载 | 只有任务处于暂停状态,才能恢复 |
文件IO | 61000 | 参数为空 | |
| 61003 | 文件或文件夹不存在 | 文件或文件夹不存在,不存在,用户删除,复制,移动几个接口 |
| 61005 | 操作失败 | 操作失败,获取文件信息,获取文件列表,获取文件摘要,公共的失败码 |
| 61008 | 传入参数不正确 | 路径不是有效路径 |
| 61010 | 不支持此类文件系统 | 不支持此类文件系统,所传路径是没有权限的路径,合法路径是指_WWW,DOC,DOCUMENTS,DOWNLOADS,路径在这4个文件夹只外会报此错 |
| 61011 | 创建文件失败 | 创建文件失败 |
| 61012 | 创建文件夹失败 | 创建文件夹失败 |
| 61014 | 文件夹不为空,不能删除 | 标文件夹存在且不为空,不能删除 |
| 61019 | 父目录不能复制或移动到子目录 | 父目录不能复制或移动到子目录 |
| 61021 | 目标文件或文件夹已存在 | 复制,移动目标文件被占用,即源文件(文件夹)和目标文件(文件夹)重名 |
二代证和活体 | 62000 | 参数为空 | 必传参数为空 |
| 62001 | 参数错误 | 参数格式,参数类型,参数名称等错误 |
| 62002 | 二代证识别错误 | 二代证识别错误(未获取相机权限,APP未找到可用的相机设备,未知错误) |
| 62004 | 活体识别错误 | 活体识别错误(未获取相机权限,APP未找到可用的相机设备,未知错误,操作超时) |
| 62006 | 活体检测超时 | 由于用户在长时间没有进行操作 |
| 62007 | 调用服务失败 | 名字+身份证信息 未通过公安系统校验 |
安全键盘 | 63001 | 参数为空 | 必传参数为空 |
| 63002 | 不支持的加密类型 | 不支持的加密类型 |
| 63003 | 参数错误 | 参数错误 |
分享 | 64000 | 没有微信客户端 | 没有微信客户端 |
| 64001 | 分享失败 | |
| 64003 | 没有找到文件 | 分享的图片,web地址,音乐地址,视频地址等找不到资源 |
| 64004 | 参数错误 | 参数格式,参数类型,参数名称等错误造成不能正确解析参数 |
| 64005 | 不支持的分享平台 | 平台参数传递错误 |
| 64006 | 未安装钉钉客户端 | |
| 64007 | 暂不支持分享该内容到微博 | |
| 64008 | 暂不支持分享该内容到微信好友 | |
| 64009 | 暂不支持分享该内容到微信朋友圈 | |
| 64010 | 暂不支持分享该内容到钉钉 | |
| 64011 | 必要参数为空 | |
图片 | 65001 | 未找到本地或网络图资源 | |
| 65002 | 保存图片失败 | |
| 65003 | 必传参数为空 | 图片资源路径不存在 |
| 65004 | 参数错误 | 传参不合法 |
文件上传 | 66001 | 参数错误 | 传参不合法 |
| 66002 | 必传参数为空 | 传参不合法 |
| 66010 | 上传任务已经不存在 | 任务已不在队列 |
| 66011 | 上传异常 | |
| 66012 | 任务没有addFile,不能开始 | 任务没有addFile,无上传文件不能开始上传 |
| 66013 | 上传任务已经开始调度 | 上传任务已经开始调度,无法追加文件 |
| 66014 | key参数中指定的键名在任务中已经存在 | addData的时候key值已存在 |
| 66015 | options参数中指定的key在任务中已经存在 | addFile的时候key值已存在 |
| 66016 | 文件路径不合法或文件不存在 | |
| 66017 | 不支持该操作 | 不支持该上传暂停和恢复 |
文件解压缩 | 67002 | 传入参数错误 | 参数错误 |
| 67004 | 操作失败 | 文件压缩,解压缩,图片压缩操作失败 |
| 67005 | 获取图片信息失败 | 图片文件数据损坏或数据格式不对,总之读取出来的图片流为空 |
| 67006 | 文件或文件夹不存在 | 文件或文件夹不存在 |
| 67007 | 不支持此类文件系统 | 不支持此类文件系统,所传路径是没有权限的路径,合法路径是指_WWW,DOC,DOCUMENTS,DOWNLOADS,路径在这4个文件夹只外会报此错 |
| 67008 | 传入参数为空 | 文件压缩,解压缩接口入参为空 |
扫码 | 68001 | 扫码失败 | |
事件(全局/局部) | 69001 | 不支持的事件类型 | 原生、JS桥接层使用 |
| 69002 | 事件监听上已绑定过当前回调,请勿重复绑定! | 主要是JS桥接层使用 |
屏幕 | 70000 | 参数为空 | 参数为空 |
| 70001 | 参数错误 | 参数错误,参数类型错误 |
通讯录 | 71000 | 没有通讯录权限 | 通讯录权限 |
| 71001 | 获取通讯录失败 | 获取通讯录失败 |
页面窗体 | 72000 | 参数错误 | 传入参数不合法,比如actionSheect传入buttons个数不合法 |
系统基本信息 | 73000 | 参数错误 | 传入参数不合法,比如actionSheect传入buttons个数不合法 |
| 73001 | 参数为空 | 传入参数为空 |
语音 | 74000 | 必要参数为空 | |
| 74001 | 合成失败 | |
用呗 | 75001 | 参数错误 | |
手势管理 | 76001 | 参数错误 | |
| 76002 | 未设置手势 | |
| 76003 | 忘记手势 | |
| 76004 | 多次输入错误手势 | |
加密解密 | 77001 | 必要参数为空 | |
| 77002 | 参数错误 | |
| 77003 | 加密失败或解密失败 | |
原生路由 | 78001 | 必要参数为空 | |
| 78002 | 参数错误 | |
音频 | 79001 | 必要参数为空 | |
| 79002 | 参数错误 | |
| 79003 | 录制失败 | |
| 79004 | 播放失败 | |
日历 | 81002 | 创建账户失败 | |
| 81005 | 参数错误 | |
| 81004 | 插入日历失败 | |
| 81001 | 参数错误 | |
错误对象
属性 | 类型 | 说明 |
status | String | 错误码源自码表 |
message | String | 错误信息 |
payload | OBJECT | 返回数据 |
传入参数OBJECT说明:
参数名 | 类型 | 是否必填 | 说明 |
classname | String | 是 | 原生实体类别名,非实现类名,android 与 iOS的类名保持一致 |
action | String | 是 | 原生实体类的方法别名,android 与 iOS的方法名保证一致 |
data | String,JsonObject,JsonArray | 是 | 该方法需要传入的参数,三种格式选择一种,如果data为空字符串,则传入值为"", 为空object,则值为{}, 为空array, 则值为[] |
callbackid | String | 是 | 接口调用结束的回调函数,为前端的回调id |