1️⃣ Python 异常链基础

Python 异常对象有几个相关属性：

属性含义

__context__ 当前异常发生时另一个异常正被处理（未被 from 显式指定）

__cause__ 通过 raise ... from ... 显式指定的异常原因

__suppress_context__ 如果为 True，在 raise ... from ... 时不显示 __context__

举例

try:

1 / 0

except ZeroDivisionError as e:

print("捕获到:", e)

简单情况没问题，但当你在 except 内又引发异常时：

try:

1 / 0

except ZeroDivisionError as e:

# 这里抛出新的异常

int("abc")

输出类似：

Traceback (most recent call last):

File "<stdin>", line 2, in <module>

ZeroDivisionError: division by zero

During handling of the above exception, another exception occurred:

Traceback (most recent call last):

File "<stdin>", line 4, in <module>

ValueError: invalid literal for int() with base 10: 'abc'

注意 During handling of the above exception, another exception occurred:

这就是 __context__ 的体现：

当前异常 (ValueError) 有上下文，指向正在处理的 ZeroDivisionError。

这发生在没有 from 时自动生成。

2️⃣ __context__ 的“意外展示”情况

情景 A：意外重复显示

try:

1 / 0

except ZeroDivisionError:

int("abc") # 新异常

except Exception as e:

print(repr(e.__context__)) # 输出 ZeroDivisionError

你可能期望 __context__ 为空，但实际上它保留了被替代的异常。

Python 会自动维护链，即使你不想要它。

情景 B：被 raise ... from None 控制

try:

1 / 0

except ZeroDivisionError:

raise ValueError("新异常") from None

except Exception as e:

print(e.__context__) # 输出 None

使用 from None 可以屏蔽上下文。

这常用于不希望泄漏内部异常信息。

3️⃣ 异常链的常见误解

误以为 __context__ 只有 raise from 才生成

❌ 错！

任何异常处理过程中出现新的异常，Python 会自动设置 __context__。

误以为 __cause__ 总是与 __context__ 一致

❌ 错！

__cause__ 是显式的，__context__ 是隐式的。

同时存在时，默认显示 __cause__，并可控制 __suppress_context__。

打印异常时的顺序可能意外

try:

1/0

except ZeroDivisionError:

int("abc")

except Exception as e:

import traceback

traceback.print_exception(type(e), e, e.__traceback__)

输出会展示链式异常，可能比你想的“单一异常”多一屏。

4️⃣ 控制异常链的技巧

方法 1：使用 from None 避免意外链

try:

1 / 0

except ZeroDivisionError:

raise ValueError("新的异常") from None

except Exception as e:

print(e.__context__) # None

阻止无关异常泄漏。

常用于 API 层或库，隐藏内部异常。

方法 2：使用 __cause__ 显式链

try:

1 / 0

except ZeroDivisionError as e:

raise ValueError("新异常") from e # 明确指定原因

异常链清晰、可控。

__context__ 会被 __cause__ 覆盖显示。

方法 3：调试时访问 __context__ 或 __cause__

try:

...

except Exception as e:

if e.__context__:

print("隐式上下文:", e.__context__)

if e.__cause__:

print("显式原因:", e.__cause__)

方便调试复杂异常链。

5️⃣ 总结

属性何时使用注意事项

__context__ 自动生成，当前异常发生时有正在处理的异常意外泄漏上下文会让日志更长

__cause__ 显式指定异常原因推荐用于库/API 层

from None 屏蔽隐式链避免泄漏内部异常

意外展示的核心原因：

Python 自动维护 __context__。

你在 except 中抛新异常时，链就产生了。

默认打印异常时会显示链，可能超出预期。

ITPub博客

Python 异常链 (context) 的意外展示

最新文章

ITPub博客

Python 异常链 (__context__) 的意外展示

最新文章

Python 异常链 (context) 的意外展示