对比结果里的 False 有两种不同意思:已经完成比较但不是同一人,或者根本没有形成可比较特征。源码还有第三种情况——特征提取异常也会变成 None。
失败信息在哪里丢失
read_image_from_bytes 捕获解码异常并返回 None;extract_face_embedding 捕获分析器异常也返回 None;正常运行但未检测到人脸同样返回 None。上层只能看到“没有 embedding”,无法区分样本问题与引擎问题。
compare_faces 把这些状态拼成六元组:是否同一人、分数、置信档、两个检测标志和消息。最终路由仍可能使用“人脸对比成功”。基础设施故障会被归入普通业务结果,也会误导重试策略。
建议显式引入可比性
可以设计三层状态:协议错误、样本不可比、推理成功。推理成功内部再区分 same 与 different。错误码应围绕原因,而不只用布尔值:
INVALID_IMAGE 图片不能解码
NO_FACE 图片可解码但没有合格人脸
MULTIPLE_FACES 不符合单人样本契约
INFERENCE_FAILED 模型或运行时失败
COMPARABLE 已形成两个可比较特征这些是重构建议,并非仓库已有字段。升级时要保留版本边界,不能直接改变旧客户端依赖的结构。
错误分类决定重试行为
坏图片重试很多次也不会变好;引擎暂时不可用可能适合有限重试;无人脸应提示换图。合并三者,客户端要么无意义重试,要么放弃可恢复任务。监控也失去区分数据质量下降和服务故障的能力。
验证时为分析器注入三种替身:返回空列表、返回有效特征、抛异常。断言不仅包括返回码,还包括可比性、日志分类与重试行为。本文做了控制流分析,未注入真实模型故障;改造需要补回归测试后再上线。
源码与阅读导航
本文属于「人脸识别服务源码笔记」第 06 篇。依据固定提交 b85ee88017bc 研读,后续版本可能不同。
全部专题与阅读顺序 · 上一篇:多人照片只取最大人脸:隐藏在算法里的业务选择 · 下一篇:人脸计数接口为什么会把推理失败包装成零个人脸
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。