人脸识别

    错误码

    私有化部署包部署成功后,即可获得与公有云基本完全相同的接口,人脸识别的相关接口将会启动,即可开始调用,若接口调用失败,则会返回Error_code,每个Error_code的说明和解决建议如下。

    若您仍然有部署及调用问题,请提交工单联系百度的工作人员


    总体说明

    本文档整理了在部署过程中遇到的常见错误码及对应解决方法,主要分为以下几类问题:

    • 返回222290错误
    • 返回222915错误
    • 返回222910错误
    • 返回222207错误
    • 错误码总览(222001--223129错误码)

    常见错误码及解决方案

    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,则说明防火墙限制了5535端口,需要用户关掉防火墙,或者单独将8443端口放开

    (4)若端口可以curl访问,继续排查问题

    3、通过日志具体信息进一步查看鉴权问题

    cat /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,则说明防火墙限制了5535端口,需要用户关掉防火墙,或者单独将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)切换用户

    su uidle-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服务或者提交工单咨询百度工作人员

    切换用户

    sui dl-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 is 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服务实例数超限 请将运行实例数控制在授权数量内
    上一篇
    接口文档
    下一篇
    运维支持