服务端已经把对比结果放进 data,仓库测试脚本却仍在顶层读取 result['is_same_person']。这说明 API 演进时,示例客户端和测试同样属于契约的一部分。
成功响应也可能触发测试异常
路由的响应形状是 {code,data,msg},业务字段在 data 内。测试在 HTTP 200 后直接读取顶层字段,可能触发 KeyError,随后被宽泛捕获并输出“请求失败”。这不证明服务没完成推理,而可能只是测试仍按旧协议解析。
payload = response.json()
assert payload['code'] == 0
result = payload['data']
assert isinstance(result['is_same_person'], bool)这段是建议的断言方式,不是已写回原仓库的补丁。还应针对不可比样本确认业务状态,不能把所有 HTTP 200 都视为正确识别。
演示脚本不是完整回归套件
现有脚本主要打印状态和结果,健康检查只判断 HTTP 状态;请求没有显式超时。脚本默认运行也没有真正执行带图片的对比和性能场景,而是提示用户修改路径。控制台出现“测试完成”,不等于核心路径已经覆盖。
回归套件应让失败传播到进程退出状态,断言字段结构、数值范围与错误契约,并使用稳定夹具。图片数据需要授权和脱敏,不能为了自动化把真实身份数据提交到公共仓库。
契约变化要成套更新
增加响应信封时,应同时更新 OpenAPI 示例、调用代码、错误解析、测试夹具和监控取值路径。最好保留旧协议迁移说明,避免服务端单方面升级造成调用者故障。
本次通过源码对照确认了取值层级不一致,没有请求实际模型接口。技术笔记应该把“服务错误”和“测试错误”分开:测试也是程序,它本身需要被审查,而不是天然正确的裁判。
源码与阅读导航
本文属于「人脸识别服务源码笔记」第 15 篇。依据固定提交 b85ee88017bc 研读,后续版本可能不同。
全部专题与阅读顺序 · 上一篇:Docker 代理排障要分层:构建容器不是镜像拉取器 · 下一篇:连续请求算出的 QPS,不是服务的最大吞吐量
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。