Python断言失败如何排查错误？

本文深入解析了 pytest 中断言失败时如何获得清晰、详细的差异对比（diff）与错误回溯，指出仅靠升级 pytest 并不够——必须同时满足三个关键条件：使用 `-vv` 详细模式参数、被比较对象为 pytest 原生支持的可序列化类型（如字典、列表、dataclass 等），且 pytest 版本 ≥7.0；文章还针对性地破解了自定义类无字段级 diff、长字符串被截断、CI 环境下 diff 消失等高频痛点，并提供了从轻量修复（如优化 `__repr__`）到根本解决（如继承 dataclass 或转为 list 比较）的实用方案，帮你告别“AssertionError: assert ...”的盲猜式调试，真正实现精准定位差异根源。

断言失败时默认只显示一行，怎么让 pytest 显示完整 diff？

pytest 默认对 assert 失败只输出单行摘要，比如 AssertionError: assert {'a': 1} == {'a': 2}，根本看不出哪一层嵌套变了。这不是 pytest 偷懒，而是它默认用的是“简洁模式”，得主动打开详细比对。

• 在运行命令里加 -vv（两个 v）：pytest -vv test_file.py，这是最直接的开关
• 如果用 assert 比较字典、列表等结构体，pytest 会自动调用内置的差异引擎，逐层标出增删改位置
• 注意：只有在测试函数里写的 assert 才受这个控制；自己写的 raise AssertionError 不走这套逻辑，不会出 diff
• Pytest 7.0+ 对嵌套对象（如含 datetime、numpy array）的 diff 支持更好，老版本可能退化成 repr() 对比

自定义对象比对不显示字段级差异，怎么让它也进 diff？

pytest 的 diff 只对内置容器（dict、list、tuple、set）和部分标准库类型（如 dataclass、namedtuple）开箱支持。你写了个类，assert obj1 == obj2 失败了，大概率只看到两行 repr()，没 diff。

• 最轻量解法：给类加 __repr__，返回易读字符串，至少能肉眼扫差异
• 真正进 diff 的路只有一条：让对象可序列化为 dict/list——要么继承 dataclass 并设 eq=True，要么手动实现 __dict__ 属性且不含不可序列化字段
• 别碰 __eq__ 里手动 raise，那会让 pytest 完全跳过结构对比，直接 fallback 到 repr()
• 第三方库如 pydantic.BaseModel 默认支持字段级 diff，但得确保没用 exclude_unset=True 这类压缩输出的配置

为什么用了 -vv 还是看不到字符串逐行 diff？

字符串太长或含控制字符时，pytest 会自动折叠，显示成 ... + 123 more，不是你漏了参数，是它做了截断保护。

• 强制展开所有：加 --tb=short 不管用，得换 --tb=long 或干脆 --tb=native，但更关键的是加 --assert=plain —— 等等，别真加，这会关掉所有智能 diff
• 正确做法：用 pytest --maxfail=1 -vv 配合 print() 在 assert 前打点，或者把长字符串赋给变量再 assert，pytest 会对变量名做识别并优先展示其内容
• 多行字符串建议先 .splitlines() 转成 list 再 assert，diff 引擎对 list 的逐行标记更稳
• 注意编码：如果字符串含 \uXXXX 转义或 raw 字符串，diff 可能显示乱码，这时用 repr(your_str) 包一层再 assert，反而更清晰

CI 环境里 pytest 报错没 diff，本地却有，怎么回事？

不是环境差异，是 CI 启动 pytest 时没传 -vv，或者用了 --tb=auto（默认值）但在管道里被重定向导致输出截断。

• 检查 CI 脚本里 pytest 命令是否带 -vv，光 -v 不够，必须两个 v
• 某些 CI 平台（如 GitHub Actions）默认把 stdout 当作流式日志，遇到超长行会丢后半段，可在命令前加 stdbuf -oL 强制行缓冲
• 如果用了 pytest-xdist 并开启多进程（-n auto），个别 worker 的输出可能被吞掉，临时禁用 xdist 测试是否恢复 diff
• 终极确认法：在 CI 里跑 pytest --help | grep 'verbose'，看是否真加载了 verbose 模式

diff 是否出现，取决于三个东西同时在线：pytest 版本够新、命令带 -vv、被比对象是它认识的结构类型。少一个，就退回原始 AssertionError 那行。很多人卡在第二步，以为装了新 pytest 就自动生效。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~