提示未检测到人脸：六个常见原因
六个原因，按出现频率排
提示「未检测到人脸」时，九成是下面六条之一：
| 原因 | 判断 | 修正 |
|---|---|---|
| 侧脸或转头 | 脸没有正对镜头 | 换正脸照 |
| 距离太远 | 脸在画面里占比太小 | 换半身或特写构图 |
| 照片糊 | 对焦失败、手抖、截图压缩 | 换清晰原图 |
| 遮挡 | 墨镜、口罩、刘海盖眼、手托腮 | 换五官完整可见的照片 |
| 合照 | 画面里有多张脸，检测到的可能不是你 | 换单人照 |
| 镜头脏 | 前摄有指纹油污（现场拍摄时） | 擦镜头重拍 |
换照片的黄金标准
一张能被稳定检测的照片 = 单人 + 正脸 + 光线均匀 + 五官无遮挡 + 脸部占比够大。这五条凑齐，检测基本一次过。完整的选择逻辑见 自拍怎么选。
换了照片还是检测不到
按顺序再查三件事：
- 权限是否被拒：应用读不了相册会表现为「选图后无响应」或检测失败——系统设置 → 应用 → Gradient → 权限，允许相机与照片 / 存储，改完不用重装；
- 照片是不是转存多手的图：社交平台保存的图普遍经过压缩裁切，画质退化严重，尽量用相册原图；
- 应用是否需要更新或清缓存：长期未更新加上缓存堆积，个别版本会出现检测异常，处理见 闪退与卡顿 的缓存清理。
与「检测到了但结果奇怪」的区别
能出结果但结果不对劲（比如血统比例离谱），不是检测问题——是特征匹配对照片敏感的正常表现，处理思路完全不同，见 测试一直转圈 的预期管理部分。