pytest的XPASS为何可能让测试套件失败：先分清结果与预期

一个原本标注为“预期失败”的测试突然通过，为什么测试套件反而显示失败？在pytest中，要先分清用例运行产生的结果，以及项目怎样处理这个结果。XPASS说的是前者；strict参数影响的是后者。[1]

pytest官方指南把skip与xfail分开解释：skip表示不运行该测试，xfail则表达由于某种原因预期测试会失败，例如功能尚未实现或缺陷尚未修好。如果标记了xfail的测试实际通过，就会报告XPASS。它不是普通失败的另一种写法，而是实际表现超出了原先的失败预期。

所读文档说明，默认情况下XFAIL和XPASS都不会让套件失败；在xfail标记上设置strict=True后，这个测试的XPASS会让套件失败。[1] 因此，“断言通过”与“整体结果可接受”并不总是同一件事。严格处理可以把需要重新检查的预期显露出来，但不能单凭这个结果判断缺陷必然已经修复。

举一个本文自拟的阅读情境：团队为一个已知缺陷保留测试，并标注预期失败。后来某次运行得到XPASS，可能意味着原先记录的失败条件需要重新核对。实际应查看输入、环境、标记条件与断言是否仍对应待验证的问题，而不是只看到通过就删除标记。本文没有运行这个例子，也未查验任何项目缺陷。

xfail还存在其他参数，不能把它们与strict混为一谈。文档说明，run=False可以让用例标记为预期失败却不实际执行；raises则能限定预期出现的异常类型，若出现其他异常仍会作为普通失败报告。[1] 阅读日志时，只有同时知道标记的条件与参数，才容易解释为何出现某类结果。

本文建议把一次XPASS记录写成“哪个用例、原先为何预期失败、这次实际报告什么、采用何种严格处理”，并附上对应运行证据。这样的记录保留了预期与事实的关系，避免把套件失败误写成该断言没有通过，也避免把意外通过宣传为整个系统已经正确。

本稿采用2026年10月9日查阅的pytest stable指南，页面未显示独立发布日期；不从示例输出推定读者安装版本，也不采用页面中不同配置文件示例来替代具体项目配置核对。本文解释的是测试结果语义，没有执行测试或给出项目已通过的结论。

参考来源：[1] pytest documentation，How to use skip and xfail to deal with tests that cannot succeed。