直接写 pytest_assertion 插件不现实，因为 pytest 未提供该扩展点，无法注册断言处理器；实际做法是通过 pytest_assertreprcompare 钩子优化失败提示，或封装 assert* 函数实现语义化校验。
为什么直接写 pytest_assertion 插件不现实？
Pytest 本身不提供“断言插件”的扩展点——它没有 pytest_assertion 这类钩子。你无法像注册 fixture 或 collector 那样注册一个自定义断言处理器。所谓“断言插件”，实际是通过 pytest_assertrepr_compare 钩子改写失败时的报错信息，或用自定义函数封装校验逻辑，再配合 assert 调用。硬要“拦截并重写 assert 行为”，会破坏 Python 的 AST 编译机制，得动 pytest 源码或用 ast 重写，代价远超收益。
用 pytest_assertrepr_compare 改写业务断言的错误提示
这是最常用、也最安全的方式：保持 assert 语法不变，仅优化失败时的输出。比如你有一组订单状态校验规则，原生 assert order.status == "paid" 失败只显示值差异，但业务上还需说明“为什么必须是 paid（如：支付网关回调后才允许发货）”。
- 在
conftest.py中实现该钩子，接收op（如"=="）、left、right - 仅当
left和right是你关心的业务对象（如Order实例）且op == "=="时，返回自定义字符串列表 - 返回值必须是
list[str]，每行一个字符串，pytest 会拼成红字报错信息 - 别试图覆盖所有类型比较——只处理你明确定义的业务对象，否则干扰其他断言
def pytest_assertrepr_compare(op, left, right):
if isinstance(left, Order) and isinstance(right, str) and op == "==":
return [
"订单状态校验失败:",
f" 期望: {right}（支付完成态）",
f" 实际: {left.status}",
f" 上游原因: {left.payment_source or '未知'}"
]
把业务校验逻辑封装成可复用的 assert_* 函数
比改写报错更直接：不依赖 assert 语句本身，而是写带语义的校验函数，内部用 assert 或 raise AssertionError，失败时自带上下文。
- 函数名明确表达意图，如
assert_order_fully_paid(order)、assert_invoice_tax_computed(invoice) - 参数做类型检查（
isinstance或pydantic.BaseModel.validate()），提前暴露数据结构问题 - 错误消息里包含业务 ID、时间戳、关键字段快照，避免翻日志查上下文
- 这类函数可被 pytest 直接调用，也能在 debug 时单独执行，比魔改 assert 更易测试和维护
def assert_order_fully_paid(order):
assert order.status == "paid", (
f"订单 {order.id} 状态非 'paid'（当前: {order.status}），"
f"但已触发发货流程，时间: {datetime.now().isoformat()}"
)
assert order.payment_amount == order.total_amount, (
f"实付金额 {order.payment_amount} ≠ 订单总额 {order.total_amount}"
)
复杂校验场景下避免过度依赖 assert 语句
当校验涉及多步骤（如“先查 DB 状态 → 再调第三方 API → 比对响应字段 → 验证幂等性”），强行塞进单个 assert 或 assert_* 函数会导致难以调试、不可复现、mock 成本高。
- 拆解为多个独立断言，每个对应一个可观测状态点，例如：
assert_db_order_status("paid")、assert_api_response_contains("transaction_id") - 用
pytest.skip()或pytest.xfail()标记依赖外部服务的校验，避免 CI 因网络抖动失败 - 对耗时操作加
@pytest.mark.timeout(5)，防止卡死；对非幂等操作加@pytest.mark.flaky(reruns=2)（需装pytest-rerunfailures） - 真正复杂的业务规则（如风控评分链路），应写成独立 service 函数，单元测试覆盖它，而非在 test case 里重复实现逻辑
业务校验越复杂，越要警惕把测试代码写成“第二个业务系统”。断言只是验证结果，不是重现实现。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
