Python 如何让异常对象携带额外上下文信息(cause vs context)

Python中异常链分显式(raise...from,设__cause__,表因果)和隐式(except中直raise,设__context__,表处理中发生),还可动态加属性附上下文,调试时可通过__cause__、__context__递归追溯。

Python 中让异常对象携带额外上下文信息,主要靠 raise ... from(显式链式异常)和隐式异常上下文(如在 except 块中重新抛出),二者语义不同:前者表示「由某异常导致」(cause),后者表示「在处理某异常时又发生了另一异常」(context)。正确区分和使用它们,能让错误溯源更清晰。

raise ... from 显式声明异常原因(cause)

当你想明确表达“当前异常是由另一个异常直接引发的”,应使用 raise new_exc from original_exc。这会设置 __cause__ 属性,并在 traceback 中以 The above exception was the direct cause of the following exception: 提示。

  • Python 会抑制原始异常的 traceback(除非启用 __suppress_context__ = False
  • from None 可完全断开链路,避免干扰(适合封装异常时隐藏底层细节)
  • 适用于转换异常类型并保留根源,例如把 ValueError 包装为自定义业务异常

示例:

try:
  int("abc")
except ValueError as e:
  raise RuntimeError("解析配置失败") from e

让异常自动获得隐式上下文(context)

当在 exceptfinally 块中未用 from 直接 raise 新异常,Python 会自动将最近未捕获的异常设为当前异常的 __context__。这表示“它发生在处理那个异常的过程中”,不强调因果,仅提供现场线索。

  • traceback 中显示 During handling of the above exception, another exception occurred:
  • 原异常仍完整保留在 traceback 中(不会被抑制)
  • 适合清理资源或日志时意外出错,比如文件关闭失败、数据库回滚异常

示例:

try:
  1 / 0
except ZeroDivisionError:
  f = open("/no/such/file")  # 这里抛出 FileNotFoundError
  raise RuntimeError("清理失败")

手动附加任意上下文信息(非链式)

若只需附带结构化数据(如请求 ID、用户 ID、输入值等),不必依赖异常链,可直接向异常实例动态添加属性:

  • 所有异常都是普通 Python 对象,支持动态赋值
  • 推荐在抛出前设置,如 exc.user_id = "u123";捕获后也可读取
  • 注意:标准库异常不预定义这些字段,需自行约定或继承自定义基类

示例:

try:
  process(data)
except ValidationError as e:
  e.request_id = "req-789"
  e.input_data = data[:100]
  raise

检查和利用异常链信息

捕获异常后,可通过以下属性访问链路:

  • exc.__cause__:显式指定的原因(raise ... from 设置)
  • exc.__context__:隐式发生的前置异常(自动填充)
  • exc.__traceback__:当前异常的 traceback 对象
  • traceback.print_exception()logging.exception() 会自动渲染完整链路

调试时可递归打印整个链:

def print_exception_chain(exc):
  while exc:
    print(repr(exc))
    exc = exc.__cause__ or exc.__context__