Python 的 raise from 到底多接了一根线?拆开 __cause__ 和 __context__ 两条异常链

简介: 把异常链写对,关键是理解 __cause__ 和 __context__ 是两条独立的记录:context 由解释器自动挂载,cause 只有写了 from 才会设。本文用本机 CPython 3.13.14 实测隐式链的字段形态、from 的 suppress_context 开关、from None 只关显示不删记录、traceback 连接语选择规则、五层因果链长度与异常对象复用的坑,附场景选择表

同一次报错,控制台可能打印两句完全不同的连接语:

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

三个变化:

  1. __cause__ 从 None 变成了那个 ZeroDivisionError。
  2. __context__ 还是同一个对象——因为 from 不改变"当时正在处理哪个异常",它只是额外记了一笔。
  3. 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__),比盯着控制台那两行连接语管用。

相关文章
|
4天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1728 3
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
4天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
3666 0
|
19天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8699 58
|
14天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3091 9
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5855 69
|
7天前
|
云安全 人工智能 安全
|
11天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1952 2