pytest-json-report 不校验 JSON 字段，仅导出测试元信息；需用 DeepDiff、jsonschema 或自定义断言函数实现结构化校验，并将差异注入 AssertionError 消息以提升报告可读性。
为什么 pytest-json-report 不能直接校验JSON字段？
它只是把测试结果（通过/失败、耗时、用例名）导出为 JSON 报告，不处理测试过程中的响应数据校验。你写 assert response.json()["code"] == 200，它不会帮你自动比对结构或忽略时间戳字段——这得靠你自己写断言逻辑。
常见错误现象：KeyError 因字段缺失、TypeError 因类型不一致、浮点数精度导致 != 失败，但报告里只显示 “AssertionError”，看不出是哪个字段飘了。
- 它不介入测试执行流，只监听 pytest 的 hook（如
pytest_runtest_makereport） - 导出的 JSON 是测试元信息，不是接口响应体
- 想靠它“自动校验API返回”属于用错了工具
真正能简化 JSON 校验的替代方案有哪些？
核心思路：把校验逻辑封装成可复用、带上下文提示的函数，而不是堆 assert。
- 用
deepdiff.DeepDiff做结构化比对：支持忽略字段（如"updated_at"）、容错浮点误差（cutoff_distance_for_pairs=1e-5），输出是 dict，可直接塞进 pytest 的assert消息里 - 用
jsonschema.validate()做契约校验：定义schema.json描述字段类型、必选、格式（如 email），一次验证整个结构，失败时提示具体路径（"$.data.user.id must be integer"） - 轻量场景直接封装
assert_json_equal(actual, expected, ignore_keys=["id", "timestamp"])，内部用json.loads()+ 字典递归比较，比对失败时打印差异行
如何让校验失败信息在 pytest-json-report 里更实用？
它的价值在于把原本藏在终端里的失败详情，变成结构化 JSON 字段（如 "longrepr"）。但默认的 traceback 对 JSON 校验帮助不大——你需要把关键比对信息显式注入失败消息。
立即学习“Python免费学习笔记（深入）”；
- 在自定义校验函数里 raise
AssertionError("字段 'price' 实际 99.99，预期 100.00 ±0.01；diff: ...")，pytest 会捕获并存入报告的longrepr - 避免用
print()或日志——它们不会进报告，只有AssertionError消息和 traceback 会被采集 - 如果用了
DeepDiff，直接把它生成的to_dict()转成字符串拼进异常消息，报告里就能看到删了哪些键、值变了几个地方
要不要配合 pytest-json-report 一起用？
可以，但仅限于“归档+人工排查”场景：比如每天定时跑全量接口测试，把生成的 report.json 丢进 CI 的 artifacts，出问题时翻 tests 数组里对应用例的 longrepr 字段。
它解决不了实时调试效率问题——你依然得在本地加 print(response.json()) 或用 logging 输出原始响应。真正的校验简化，发生在 assert 层，不在报告层。
容易被忽略的一点：很多人把 response.json() 直接当 dict 用，却忘了它可能抛 JSONDecodeError。校验前先包一层 try-except 并转成明确的 AssertionError，否则 pytest 报告里只会显示未捕获异常，根本看不到 JSON 内容。
