42 lines
1.7 KiB
Markdown

---
id: checkin.face-fail.faq
title: 人脸识别失败怎么办
type: faq
feature: checkin
scope: end-user
locale: zh
aliases:
- 人脸识别失败
- 刷脸不成功
- 人脸录入失败
- 上传人脸报错
- 识别不到我的脸
related_tools: []
related_pages: []
prerequisites: []
last_verified: 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 后人脸签到能力完全消失