资讯 社区 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

错误码

私有化部署包部署成功后,即可获得与公有云基本完全相同的接口,人脸识别的相关接口将会启动,即可开始调用,若接口调用失败,则会返回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端口放开
  • 若出现下图所示内容,则说明容器能访问数据库服务,继续进行排查

img

(2)也可能是指纹文件发生变化,导致鉴权失败

排查方法:确认是否运行鉴权服务的物理机发生变化,如硬盘、网卡等

  • 若发生变化,重新提取指纹,申请授权
  • 如没有发生变化,则继续排查问题

(3)检查鉴权服务是否启动

排查方法:输入以下命令查看服务是否返回以下信息:

netstat -anp |grep 8443
  • 如果启动失败则不返回任何结果,需要重新启动鉴权服务,输入以下命令进行重新启动
cd /home/baidu/work/c-offline-security-server/ && nohup bash start/c-offline-security-server-start.sh &
  • 如果启动成功返回以下信息,继续进行问题排查

img

(4)检查是否超出feature-frame最大并发时,也会返回222915错误

解决方案:用户根据自己的业务需求判断业务并发数是否超过最大并发支持

  • 若超过,需要用户增加实例,减少运行模型的服务器数量、或实例数量
  • 若没有超过,则继续进行问题排查

(5)检查是否产品授权过期

解决方案:如果您购买的是测试版的授权服务,请您到百度云控制台检查您的服务有效期

  • 若已到期,可以申请延长试用期或申请正式版服务,正式版永久有效
  • 若服务未到期,请提交工单联系百度工作人员进行解决

3. 返回222910错误

(1)检查数据库服务是否启动

解决方案:退出容器在服务器上执行以下命令

ps aux|grep databus
  • 若未出现任何提示,则重新启动数据库服务
  • 若出现以下内容,则说明数据库服务已启动,继续进行问题排查

img

(2)检查数据库地址或者端口是否填写错误

解决方案:进入容器,输入以下命令查看地址和端口是否正确

cat /home/idl-face/odp/conf/db/cluster.conf

查看结果参考下图所示:

img

  • 若地址和端口号错误,请将数据库的地址及端口号修改正确
  • 若没有问题,请继续排查问题

所有ip和port都要改成数据库服务的地址和端口

(3)可能是由于防火墙的问题,容器内无法访问数据库服务

排查方法:在容器中执行 curl 服务器IP:端口号

  • 若出现curl: (7) Failed connect to 10.233.42.40:5535; Connection refused,则说明防火墙限制了5535端口,需要用户关掉防火墙,或者单独将5335端口放开
  • 若出现下图所示内容,则说明容器能访问数据库服务,继续进行排查

img

4. 返回222207错误(调用1:N接口时)

(1)检查是否是空人脸组

解决方案:查看该人脸组下是否有用户

  • 如果人脸组下没有用户,请添加用户后继续重新调取接口访问
  • 如果人脸组下有用户,或添加用户后仍然返回222207错误提示,则可能是数据库未正常连接,请参考下一条继续排查

(2)检查数据库是否都正常连接

解决方案:按以下步骤查看数据库是否正常连接

(一)检查数据库地址或者端口是否填写错误

解决方案:进入容器,输入以下命令查看地址和端口是否正确

cat /home/idl-face/odp/conf/db/cluster.conf

查看结果参考下图所示:

img

  • 若地址和端口号错误,请在文件中将数据库的地址及端口号修改正确
  • 若没有问题,请继续排查问题

所有ip和port都要改成数据库服务的地址和端口

(二)查看数据库是否正常连接

解决方案:执行 ps aux|grep databus命令,查看数据库是否启动

ps aux|grep databus
  • 如果出现图中内容,说明服务器没有启动数据库服务,如果没有启动需要手动启动数据库服务,并且重新启动容器

img

手动启动数据库服务:

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>
  • 若返回以下内容,则说明数据库连接正常,继续排查问题。

img

(三)检查是否是数据异常

解决方案:需要进入/home/idl-face/public_bridge/log/目录查看bridge.INFO文件

  • 若返回下图内容,则说明数据异常

img

需要执行以下操作步骤:

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 目标用户组下找不到该用户 请在目标用户组下添加该用户后重新调取接口访问
上一篇
接口文档
下一篇
常见问题及排查