Python 异常链 traceback 的生成过程

python异常链需用raise ... from ...显式触发，__cause__为显式原因，__context__为隐式上下文；两者共存时traceback显示对应提示，调试需注意日志和工具对链的支持。

Python 里 raise ... from ... 怎么触发异常链

异常链不是自动产生的，必须显式用 from 关键字连接两个异常，否则即使在 except 块里 raise 新异常，也不会形成链式 traceback。

常见错误现象：raise ValueError("bad input") 在捕获 KeyError 后直接抛出，结果 traceback 只显示 ValueError，原始 KeyError 完全丢失。

• 正确写法是 raise ValueError("bad input") from e，其中 e 是捕获到的原始异常对象
• 如果想抑制原始异常（只显示新异常），写成 raise ValueError("bad input") from None
• from 后面必须是异常实例或 None，不能是字符串、类型名或未赋值变量，否则报 TypeError: __cause__ must be an exception instance or None

为什么 __cause__ 和 __context__ 都会出现

Python 自动设置 __context__（隐式上下文）用于未用 from 的嵌套异常；__cause__（显式原因）只在 raise ... from ... 时被赋值。两者共存时，traceback 会先显示 “The above exception was the direct cause of the following exception:” 这类提示。

使用场景：调试时看到两段 traceback，别急着删代码——可能只是你没加 from，Python 自动补了 __context__。

立即学习“Python免费学习笔记（深入）”；

08cms企业建站系统 1.0 正式版

08cms企业建站系统是基于08cmsv3.4核心程序，通过系统架构，模板制作，并根据此系统的功能和操作流程进行了代码优化。由08cms官方团队开发。安装链接：install.php、管理后台链接：admina.php日常管理请不要使用创始人帐号（admin），系统内置有内容管理帐号08cms：密码08cms系统特点：1、系统可自动生成静态页面；2、根据企业系统的特点，基于08cms V3.4核心

下载

• 手动设置 __cause__ 不推荐，应始终用 raise ... from ... 语法
• __context__ 在 try/except 外抛异常时不会被设置，仅限“在处理另一个异常时又抛出新异常”的情况
• 性能上无差异，但混用 __cause__ 和 __context__ 会让 traceback 更难读，尤其对不熟悉异常链机制的人

traceback 输出里 “During handling of the above exception…” 是哪来的

这句话对应的是 __context__ 触发的隐式链，不是 bug，也不是配置问题，是 Python 解释器的标准行为。

容易踩的坑：logging.exception() 或 IDE 控制台默认只打印最外层异常，可能看不到完整链；需确保用 traceback.print_exception() 并传入全部三个参数（type, value, tb），或用 traceback.format_exception() 才能保留链式结构。

• IPython/Jupyter 默认展示完整链，但普通 Python CLI 可能截断，注意观察输出末尾是否有 “...” 或换行缺失
• Django 等框架有时会重写异常处理器，导致 __cause__ 被丢弃，此时要检查中间件或日志配置是否调用了 exc_info=False
• pytest 捕获异常时默认展示链，但加了 --tb=short 会隐藏中间环节，调试时建议用 --tb=long

自定义异常类怎么参与异常链

不需要额外操作。只要继承 Exception（或其子类），就能正常被 raise ... from ... 引用，也能作为 __cause__ 或 __context__ 存储。

唯一要注意的是：如果重写了 __init__ 且没调用 super().__init__()，可能导致异常消息丢失，但不影响链本身。

• 异常链不依赖 __str__ 或 args，只依赖异常对象的身份和 __cause__/__context__ 属性
• 不要在自定义异常里手动赋值 self.__cause__，这会被解释器忽略，必须用 raise ... from ...
• 若需携带额外上下文（如请求 ID），建议通过异常属性（如 e.request_id = "abc123"）附加，而不是试图塞进 traceback 链