// LATEST

人脸计数接口为什么会把推理失败包装成零个人脸

“图片没有人脸”和“模型没能完成检测”都可能得到零,但两者绝不能互相替代。计数接口里一个被解包后没有使用的变量,正好暴露了这个边界。

四元组中被忽略的字段

核心服务 count_faces 返回 (face_count, success, message, face_details)。正常检测到零个人脸时,success=True;图片读取失败或分析器抛异常时,success=False。这本来保留了很有用的区别。

但异步适配函数接到四元组后,只用 face_count > 0 构造 faces_detected,没有使用 success。路由继续用 code=0 和“人脸计数成功”包装响应。下游若只看计数,会把服务失败当成“合格地检出了零”。

不启动模型也能验证

本次隔离提取原适配函数,把服务替换成返回 (0,False,'synthetic inference failure',[]) 的桩,并运行真实执行器调度。结果对象中没有 success,faces_detected=False,失败原因只剩在自由文本 message 里。

这个检查验证的是状态传播,不是模型准确率,也没有调用真实人脸检测。对这类缺陷,替身比加载整套推理依赖更直接。

让状态可以被机器消费

建议返回稳定的结果状态或错误码:正常零人脸仍是有效检测结果;坏图片属于输入问题;模型不可用属于服务故障。外层是否使用非 2xx,需要结合既有客户端兼容性决定,但不能只靠中文消息进行分支判断。

检测完成 + count=0  → 可以提示换图
输入解码失败       → 应修正上传内容
推理引擎失败       → 应告警并按策略有限重试

回归测试的最小矩阵

至少为“零人脸但成功”“一人脸”“多人脸”“无法解码”“分析器异常”分别断言状态、数量、明细长度和外层信封。成功时应满足 face_count == len(face_details);失败时应避免将空明细误当作有效证据。

这条问题不是多加一段异常捕获就能解决,而是要让核心服务已经表达的信息穿过适配层。接口契约中的每个字段,都应有明确的消费位置。


源码与阅读导航

本文属于「人脸识别服务源码笔记」第 07 篇。依据固定提交 b85ee88017bc 研读,后续版本可能不同。

全部专题与阅读顺序 · 上一篇:无人脸、坏图片、模型故障,不应该共享一个失败值 · 下一篇:线程池不等于无限并发:人脸推理服务的排队边界

还没有评论

欢迎留下你的观点,保持交流的清晰和友好。

写下评论