同一次报错,控制台可能打印两句完全不同的连接语:
The above exception was the direct cause of the following exception:
或者:
During handling of the above exception, another exception occurred:
这两句长得像,含义却差得远。它们分别对应异常对象上的两个字段:__cause__ 和 __context__。这篇文章把两条链拆开,一个字段一个字段地看。
本文所有输出都在 CPython 3.13.14 本机实测。
一、先把两个字段打印出来
先看最常见的写法:在 except 里捕获一个异常,然后抛出另一个,不写 from。
def f1():
try:
d = {
}
d['k']
except KeyError:
raise ValueError('外层报错')
try:
f1()
except ValueError as e:
print('__cause__ =', repr(e.__cause__))
print('__context__ =', repr(e.__context__))
print('suppress_context=', e.__suppress_context__)
输出:
__cause__ = None
__context__ = KeyError('k')
suppress_context= False
三个值很关键:
__cause__是None——你没写from,就没有显式因果。__context__是那个KeyError('k')——Python 自己挂上去的。suppress_context是False——意思是"这个 context 可以显示"。
所以隐式链不是不存在,它一直在,只是你看不见那个字段名。
二、隐式链:只要在 except 里抛新异常,就自动接上
__context__ 的挂载时机很固定:当异常在另一个异常的处理过程中被抛出时,解释器把"正在处理的异常"记到新异常的 __context__ 上。
这几个场景都会触发:
| 写法 | __context__ |
|---|---|
except 块里 raise X |
被捕获的那个异常 |
except 块里调用函数,函数里抛 |
同上 |
finally 里 raise |
正在传播的那个异常 |
没有 except,单纯 raise X |
None |
表格第三行值得单独说:finally 里的 raise 会覆盖掉正在往外走的异常,但原异常不会丢,它被塞进了新异常的 __context__。
这也是"日志里为什么能看到两个 traceback"的来源——不是打印了两遍,是一条链。
三、显式 from:设 __cause__,顺手把开关翻过去
同样的代码,把 raise ValueError(...) 改成 raise ValueError(...) from inner:
def f2():
try:
1 / 0
except ZeroDivisionError as inner:
raise ValueError('外层报错') from inner
实测输出:
__cause__ = ZeroDivisionError('division by zero')
__context__ = ZeroDivisionError('division by zero')
suppress_context= True
三个变化:
__cause__从None变成了那个ZeroDivisionError。__context__还是同一个对象——因为from不改变"当时正在处理哪个异常",它只是额外记了一笔。suppress_context翻成了True。
第 3 点最容易被忽略。from 真正干的事是:先记 __cause__,再把 suppress_context 置 True,告诉 traceback 打印时"别用 context 那条,用 cause 这条"。
换句话说,from 并没有把 __context__ 清掉,它只是让显示层闭嘴。
四、from None:只关显示,不删记录
还有一个常被当成"清空异常"的写法:
try:
try:
1 / 0
except ZeroDivisionError:
raise ValueError('只报这一个') from None
except ValueError as e:
print('__cause__ =', repr(e.__cause__))
print('__context__ =', repr(e.__context__))
print('suppress_context=', e.__suppress_context__)
输出:
__cause__ = None
__context__ = ZeroDivisionError('division by zero')
suppress_context= True
from None 的效果是:__cause__ 保持 None,但 suppress_context 变成 True。
也就是说,那个 ZeroDivisionError 还在对象上,程序里读 e.__context__ 一样能拿到。变的只是 traceback 打不打印。
所以 from None 不是"吞掉异常",它是"别让人看见上一层"。真正要排查问题时,把 __context__ 打出来,链还在。
五、traceback 到底读哪一条
把三种写法的 format_exc() 拿出来,只看连接语那一行:
| 写法 | 连接语 | __cause__ |
__context__ |
suppress_context |
|---|---|---|---|---|
raise X(在 except 里) |
During handling of the above exception, another exception occurred: | None | 有 | False |
raise X from e |
The above exception was the direct cause of the following exception: | 有 | 有 | True |
raise X from None |
(不打印连接语) | None | 有 | True |
规则可以压成一句话:
先看
__cause__。有就按"直接原因"打印;没有就再看__context__,且suppress_context为False时按"处理过程中又发生"打印;否则什么都不打。
链还可以更长。实测叠五层:
def chain(n):
if n == 0:
raise RuntimeError('底')
try:
chain(n - 1)
except RuntimeError as e:
raise RuntimeError('第%d层' % n) from e
顺着 e.__cause__ 一路走,得到长度 5。所以 __cause__ 是单链表,一层指一层,不是树。
六、一个容易踩的细节:异常对象可以复用
shared = KeyError('共享')
def g1():
raise shared
def g2():
raise ValueError('包一层') from shared
先 g1() 抛一次,再 g2() 抛一次,然后检查:
外层 cause is shared = True
shared 仍有 traceback = True
同一个异常对象被 raise 两次,第二次的 __cause__ 依然指向它,而它身上还留着第一次的 __traceback__。
后果是:如果日志里看到异常的 traceback 起点很奇怪,先确认这个异常对象是不是被复用过的模块级常量。异常不是值类型,它带状态。
七、工程上怎么选
三个写法各有各的场合,我的习惯是这样:
| 场景 | 写法 | 理由 |
|---|---|---|
| 底层异常对排查有用,要保留 | raise NewError(...) from e |
读者能看到"直接原因",链完整 |
| 底层异常是实现细节,不该暴露 | raise NewError(...) from None |
只露一层,但 __context__ 还在,自己排查时能捞出来 |
| 临时调试,先不动结构 | 什么都不写 | __context__ 自动接上,够看 |
| 把异常包成业务错误码 | from e + 自定义属性 |
链留着,额外挂 code、payload |
一个反例:在批量任务里,把每个失败项包成 BatchError 时不写 from,日志会堆出一大串"During handling of the above exception",读起来像二十个独立故障,其实是同一个根因。加上 from e,连接语统一成"direct cause",一眼能看出是一棵因果树。
小结
- 隐式链靠
__context__,自动挂,suppress_context=False。 - 显式链靠
__cause__,from e才设,同时把suppress_context置True。 from None只改suppress_context,不删__context__。- traceback 的打印顺序是
__cause__优先,其次才是__context__。 - 异常对象带状态,别拿它当值类型反复
raise。
两条链都在异常对象上,随时能读。真出问题时,先 repr(e.__context__),比盯着控制台那两行连接语管用。