错误码
私有化部署包部署成功后,即可获得与公有云基本完全相同的接口,人脸识别的相关接口将会启动,即可开始调用,若接口调用失败,则会返回Error_code,每个Error_code的说明和解决建议如下。
若您仍然有部署及调用问题,请提交工单联系百度的工作人员
总体说明
本文档整理了在部署过程中遇到的常见错误码及对应解决方法,主要分为以下几类问题:
- 返回222290错误
- 返回222915错误
- 返回222910错误
- 返回222207错误
- 错误码总览(222001--223140错误码)
常见错误码及解决方案
1. 返回222290错误
1、输入以下命令查看鉴权是否启动
netstat -apn|grep 8443
(1)如果没有启动,则启动鉴权
cd /home/baidu/work/c-offline-security-server/ && nohup bash start/c-offline-security-server-start.sh &
(2)若鉴权服务已启动,则继续排查
2、进入容器判断鉴权端口(8443端口)是否处于可访问状态
(1)进入容器
(2)curl端口是否可访问
curl 鉴权IP:8443
(3)若出现curl: (7) Failed connect to 10.233.42.40:8443; Connection refused,或者no route to host 则说明防火墙限制了8443端口,需要用户关掉防火墙,或者单独将8443端口放开
(4)若端口可以curl访问,继续排查问题
3、通过宿主机鉴权日志具体信息进一步查看鉴权问题
cd /home/baidu/work/c-offline-security-server/log/ #进入鉴权日志目录
查看aipe_info+日期.log
具体日志排查参考常见问题文档。
若经过上述排查后,仍有问题,请提交工单联系百度工作人员进行解决
2. 返回222915错误
(1)可能是由于防火墙的问题,容器内无法进行访问数据库服务
排查方法:在容器中执行 curl 服务器IP:端口号
- 若出现curl: (7) Failed connect to 10.233.42.40:8443; Connection refused,则说明防火墙限制了8443端口,需要用户关掉防火墙,或者单独将8443端口放开
- 若出现下图所示内容,则说明容器能访问数据库服务,继续进行排查
(2)也可能是指纹文件发生变化,导致鉴权失败
排查方法:确认是否运行鉴权服务的物理机发生变化,如硬盘、网卡等
- 若发生变化,重新提取指纹,申请授权
- 如没有发生变化,则继续排查问题
(3)检查鉴权服务是否启动
排查方法:输入以下命令查看服务是否返回以下信息:
netstat -anp |grep 8443
- 如果启动失败则不返回任何结果,需要重新启动鉴权服务,输入以下命令进行重新启动
cd /home/baidu/work/c-offline-security-server/ && nohup bash start/c-offline-security-server-start.sh &
- 如果启动成功返回以下信息,继续进行问题排查
(4)检查是否超出feature-frame最大并发时,也会返回222915错误
解决方案:用户根据自己的业务需求判断业务并发数是否超过最大并发支持
- 若超过,需要用户增加实例,减少运行模型的服务器数量、或实例数量
- 若没有超过,则继续进行问题排查
(5)检查是否产品授权过期
解决方案:如果您购买的是测试版的授权服务,请您到百度云控制台检查您的服务有效期
- 若已到期,可以申请延长试用期或申请正式版服务,正式版永久有效
- 若服务未到期,请提交工单联系百度工作人员进行解决
3. 返回222910错误
(1)检查数据库服务是否启动
解决方案:退出容器在服务器上执行以下命令
ps aux|grep databus
- 若未出现任何提示,则重新启动数据库服务
- 若出现以下内容,则说明数据库服务已启动,继续进行问题排查
(2)检查数据库地址或者端口是否填写错误
解决方案:进入容器,输入以下命令查看地址和端口是否正确
cat /home/idl-face/odp/conf/db/cluster.conf
查看结果参考下图所示:
- 若地址和端口号错误,请将数据库的地址及端口号修改正确
- 若没有问题,请继续排查问题
所有ip和port都要改成数据库服务的地址和端口
(3)可能是由于防火墙的问题,容器内无法访问数据库服务
排查方法:在容器中执行 curl 服务器IP:端口号
- 若出现curl: (7) Failed connect to 10.233.42.40:5535; Connection refused,则说明防火墙限制了5535端口,需要用户关掉防火墙,或者单独将5335端口放开
- 若出现下图所示内容,则说明容器能访问数据库服务,继续进行排查
4. 返回222207错误(调用1:N接口时)
(1)检查是否是空人脸组
解决方案:查看该人脸组下是否有用户
- 如果人脸组下没有用户,请添加用户后继续重新调取接口访问
- 如果人脸组下有用户,或添加用户后仍然返回222207错误提示,则可能是数据库未正常连接,请参考下一条继续排查
(2)检查数据库是否都正常连接
解决方案:按以下步骤查看数据库是否正常连接
(一)检查数据库地址或者端口是否填写错误
解决方案:进入容器,输入以下命令查看地址和端口是否正确
cat /home/idl-face/odp/conf/db/cluster.conf
查看结果参考下图所示:
- 若地址和端口号错误,请在文件中将数据库的地址及端口号修改正确
- 若没有问题,请继续排查问题
所有ip和port都要改成数据库服务的地址和端口
(二)查看数据库是否正常连接
解决方案:执行 ps aux|grep databus命令,查看数据库是否启动
ps aux|grep databus
- 如果出现图中内容,说明服务器没有启动数据库服务,如果没有启动需要手动启动数据库服务,并且重新启动容器
手动启动数据库服务:
a. 切换到idl-face用户
su idl-face
b. 进入databus5535目录
cd /home/idl-face/databus5535/bin/
c. 启动服务
nohup ./mysqld_safe --defaults-file=../etc/my.cnf &
重新启动容器:
a. 使用以下命令查看容器ID
docker ps -a
回显的CONTAINER ID就是容器ID。
b. 使用以下命令重启服务
docker restart <容器ID>
- 若返回以下内容,则说明数据库连接正常,继续排查问题。
(三)检查是否是数据异常
解决方案:需要进入/home/idl-face/public_bridge/log/目录查看bridge.INFO文件
- 若返回下图内容,则说明数据异常
需要执行以下操作步骤:
1)进入容器,切换用户
docker ps -a #查看所有容器
docker exec -it (container_id) /bin/bash #进入到container_id容器
切换用户: su idl-face
2)关闭bridge服务
cd /home/idl-face/public_bridge/bin
./bridge.sh stop
3)更新数据位置
cd /home/idl-face/public_bridge
bash update-pos.sh
4)启动bridge服务
cd /home/idl-face/public_bridge/bin
./bridge.sh start
(四)重启aise服务或者提交工单咨询百度工作人员
进入容器,切换用户
docker ps -a #查看所有容器
docker exec -it (container_id) /bin/bash #进入到container_id容器
切换用户: su idl-face
进入/home/idl-face/aise-service/bin目录,关闭aise服务
cd /home/idl-face/aise-service/bin
./face-aise_control stop
更新数据
bash update-data.sh
启动aise服务
./face-aise_control start
错误码总览
错误码 | 错误信息 | 说明 | 处理建议 |
---|---|---|---|
222001 | param[] is null | 必要参数未传入 | 参考API说明文档,修改参数 |
222002 | param[start] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222003 | param[length] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222004 | param[op_app_id_list] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222005 | param[group_id_list] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222006 | group_id format error | 参数格式错误 | 参考API说明文档,修改参数 |
222007 | uid format error | 参数格式错误 | 参考API说明文档,修改参数 |
222008 | face_id format error | 参数格式错误 | 参考API说明文档,修改参数 |
222009 | quality_conf format error |
参数格式错误 | 参考API说明文档,修改参数 |
222010 | user_info format error | 参数格式错误 | 参考API说明文档,修改参数 |
222011 | param[uid_list] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222012 | param[op_app_id] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222013 | param[image] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222014 | param[app_id] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222015 | param[image_type] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222016 | param[max_face_num] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222017 | param[face_field] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222018 | param[user_id] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222019 | param[quality_control] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222020 | param[liveness_control] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222021 | param[max_user_num] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222022 | param[id_card_number] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222023 | param[name] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222024 | param[face_type] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222025 | param[face_token] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222026 | param[max_star_num] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222027 | code length param error | 验证码长度错误 (最小值大于最大值) |
参考API说明文档,修改参数 |
222028 | param[min_code_length] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222029 | param[max_code_length] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222030 | param[match_threshold] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222200 | request body should be json format | 该接口需使用 application/json的 格式进行请求 |
请修改接口格式为: application/json |
222201 | network not available | 服务端请求失败 | 重新尝试 |
222202 | pic not has face | 图片中没有人脸 | 检查图片质量 |
222203 | image check fail | 无法解析人脸 | 检查图片质量 |
222204 | image_url_download_fail | 从图片的url下载 图片失败 |
请确认url可公网访问 |
222205 | network not availablel | 服务端请求失败 | 重新尝试 |
222206 | rtse service return fail | 服务端请求失败 | 重新尝试 |
222207 | match user is not found |
未找到匹配的用户 | 请确认人脸库中 是否存在此用户 |
222208 | the number of image is incorrect |
图片的数量错误 | 多张图片请使用 json格式传输 |
222209 | face token not exist | face token不存在 | 请确认您操作的 人脸已创建成功; 若face_token未注册到 人脸库则有效期只有1小时 注册人脸库的 face_token永久有效 |
222210 | the number of user's faces is beyond the limit | 人脸库中用户下的人脸数目超过限制 | 当前每个用户下限制人脸数目最大20张 |
222300 | add face fail | 人脸图片添加失败 | 重新尝试 |
222301 | get face fail | 获取人脸图片失败 | 请重新尝试, 如果持续出现此类错误, 请提交工单 |
222302 | system error | 服务端请求失败 | 重新尝试 |
222303 | get face fail | 获取人脸图片失败 | 请重新尝试, 如果持续出现此类错误,请提交工单 |
223100 | group is not exist | 操作的用户组不存在 | 请确认您操作的 用户组已创建成功 |
223101 | group is already exist | 该用户组已存在 | 请不要重复创建用户组 |
223102 | user is already exist | 该用户已存在 | 请不要重复创建用户 |
223103 | user is not exist | 找不到该用户 | 请确认您操作的 用户已创建成功 |
223104 | group_list is too large | group_list包含组 数量过多 |
请按照文档提示 设置group_list参数 |
223105 | face is already exist | 该人脸已存在 | 请不要重复添加人脸 |
223106 | face is not exist | 该人脸不存在 | 请确认您操作的 人脸已创建成功; 若face_token未注册到 人脸库则有效期只有1小时, 注册人脸库的 face_token永久有效 |
223110 | uid_list is too large | uid_list包含数量过多 | 请按照文档提示 设置user_list参数 |
223111 | dst group not exist | 目标用户组不存在 | 请确认您操作的 用户组已创建成功 |
223112 | quality_conf format error |
quality_conf格式不正确 | 请按照文档提示设置 quality_conf参数 |
223113 | face is covered | 人脸有被遮挡 | 提示用户请勿遮挡面部 |
223114 | face is fuzzy | 人脸模糊 | 人脸图片模糊, 前端页面可以提示 用户拍摄时不要晃动手机 |
223115 | face light is not good | 人脸光照不好 | 提示用户到光线适宜的地方拍摄 |
223116 | incomplete face | 人脸不完整 | 提示用户请勿遮挡面部 |
223117 | app_list is too large | app_list包含app数量 过多 |
请按照文档提示设置 app_list参数 |
223118 | quality control error | 质量控制项错误 | 请按照文档提示设置 质量控制参数 |
223119 | liveness control item error |
活体控制项错误 | 请按照文档提示设置 活体控制参数 |
223120 | liveness check fail | 活体检测未通过 | 此次活体检测结果为非活体 |
223121 | left eye is occlusion | 质量检测未通过 左眼 遮挡程度过高 |
提示用户请勿遮挡左眼 |
223122 | right eye is occlusion | 质量检测未通过 右眼 遮挡程度过高 |
提示用户请勿遮挡右眼 |
223123 | left cheek is occlusion | 质量检测未通过 左脸 遮挡程度过高 |
提示用户请勿遮挡左脸颊 |
223124 | right cheek is occlusion |
质量检测未通过 右脸 遮挡程度过高 |
提示用户请勿遮挡右脸颊 |
223125 | chin contour is occlusion |
质量检测未通过 下巴遮挡程度过高 | 提示用户请勿遮挡下巴 |
223126 | nose is occlusion | 质量检测未通过 鼻子遮挡程度过高 | 提示用户请勿遮挡鼻子 |
223127 | mouth is occlusion | 质量检测未通过 嘴巴 遮挡程度过高 |
提示用户请勿遮挡嘴巴 |
222901 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222902 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222903 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222904 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222905 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222906 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222907 | system busy | 缓存处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222908 | system busy | 缓存处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222909 | system busy | 缓存处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222910 | system busy | 数据存储处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222911 | system busy | 数据存储处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222912 | system busy | 数据存储处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222913 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222914 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222915 | system busy | 后端服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222916 | system busy | 后端服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222304 | image size is too large | 图片尺寸太大 | 请确保图片尺寸在1920x1080以下下 |
223128 | group was deleting | 正在清理该用户组的数据 | 请等该用户组清理完毕后再对 该组进行操作 |
222361 | system busy | 公安服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222046 | param[template_type] format error | 参数格式错误 | 请参考接口文档修改 |
222101 | param[merge_degree] format error | 参数格式错误 | 请参考API说明文档,修改参数 |
222102 | param[face_location] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222307 | image illegal, reason: porn | 图片非法 鉴黄未通过 | 请重新上传合法的图片 |
222308 | image illegal, reason: sensitive person | 图片非法 含有政治敏感人物 | 请重新上传合法的图片 |
222211 | template image quality reject | 人脸融合失败 模板图质量不合格 | 请检查模板图是否符合 人脸融合文档中的质量要求 |
222212 | merge face fail | 人脸融合失败 | 请更换素材后重新尝试, 如果持续出现此类错误,请提交工单 |
223129 | face not forward | 人脸未面向正前方 (人脸的角度信息大于30度) |
请使用面向正前方的人脸图片 |
222290 | auth fail | feature服务鉴权失败 | 请检查授权服务运行正常,网络通畅 |
222291 | qps exceed maximum | feature服务QPS超限 | 请降低服务访问频率 |
222292 | auth expired | feature服务鉴权过期 | 请联系服务人员更新授权文件 |
222293 | instance exceed maximum | feature服务实例数超限 | 请将运行实例数控制在授权数量内 |
223140 | group user is not exist | 目标用户组下找不到该用户 | 请在目标用户组下添加该用户后重新调取接口访问 |