dootask/resources/ai-kb/zh/faq/checkin/face-fail.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	last_verified
checkin.face-fail.faq	人脸识别失败怎么办	faq	checkin	end-user	zh	人脸识别失败 刷脸不成功 人脸录入失败 上传人脸报错 识别不到我的脸				v1.7.90

人脸识别失败怎么办

问题

上传人脸图片或现场扫脸时报错，比如「设置失败」「上传出错」「未识别到人脸」「该应用未安装」等。

原因

• face 插件没装：主程序调 face 容器 http://face:7788/user 调不通，会先抛 请先安装 face 异常
• face 容器没起来：容器异常或镜像没拉成功（约 15MB+，首次安装慢）
• 签到方式没开人脸：管理员未在「签到设置 → 签到方式」勾选「人脸签到」
• 未开放上传：管理员未在「签到设置 → 允许修改」开启「允许成员上传人脸图片」，提交会返回「未开放修改权限」
• 图片质量差：模糊 / 侧脸 / 多人 / 太暗 → 后端识别引擎拒绝入库
• 现场设备问题：人脸识别一体机离线、网络断、未对接到 face 容器

解决

1. 联系管理员确认 face 插件已在应用市场安装
2. 让管理员去「签到设置」开启「人脸签到」+「允许成员上传人脸图片」
3. 重新上传一张正面、光线均匀、单人、500x500 左右的清晰照片
4. 现场扫脸失败时换个角度 / 摘掉口罩 / 重启设备
5. 若一直失败，临时改用 checkin.regular.howto 手动签到或 checkin.wifi.howto WiFi 签到

不支持

• 主程序自己不做人脸比对，所有错误都从 face 插件返回；卸载 face 后人脸签到能力完全消失