# 全局错误码

"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
Last Updated: 3/13/2024, 11:30:45 AM