如何在Python 3.11中使用except*处理异常组-Python教程-PHP中文网

except*是Python 3.11专为解包ExceptionGroup设计的语法，它不匹配异常组本身，而是匹配其内部所有指定类型的子异常并返回新ExceptionGroup；而普通except仅捕获单个异常，两者不可混用且语义完全不同。

如何在python 3.11中使用except*处理异常组

什么是 `except*`？它和普通 `except` 有什么本质区别

except* 是 Python 3.11 引入的语法，专为处理 ExceptionGroup（异常组）设计，不是用来替代传统单异常捕获的。如果你用它捕获一个普通异常（比如 ValueError），会直接报 SyntaxError: invalid syntax —— 因为语法本身要求右侧必须是能匹配异常组中「部分子异常」的类型。

它的核心行为是：**尝试对异常组里的每个子异常分别匹配，成功则执行对应块，并从原组中移除该子异常；所有匹配失败后，剩余未处理的子异常会自动重新抛出为新的 ExceptionGroup**。

常见错误现象：
- 写 except* ValueError: 却捕获了一个纯 ValueError（非 ExceptionGroup），直接语法错误
- 在非 try 块里用 except*，或嵌套在普通 except 下，同样报错

怎么触发 `ExceptionGroup` 才能让 `except*` 生效

你不能手动写 raise ExceptionGroup(...) 来测试（虽然可以），但真实场景几乎都来自 asyncio.gather(..., return_exceptions=True) 或 threading / concurrent.futures 的批量任务失败，或者显式调用 raise ExceptionGroup("msg", [exc1, exc2])。

示例场景：

import asyncio
<p>async def fails_twice():
raise ValueError("first")</p><p>async def fails_also():
raise TypeError("second")</p><p>async def main():</p><h1>这里会返回一个 ExceptionGroup，包含两个子异常</h1><pre class="brush:php;toolbar:false;">results = await asyncio.gather(
    fails_twice(), fails_also(),
    return_exceptions=True
)
if any(isinstance(r, BaseException) for r in results):
    raise ExceptionGroup("batch failed", [r for r in results if isinstance(r, BaseException)])

try: asyncio.run(main()) except ValueError as eg: print(f"Caught ValueError group: {eg.exceptions}") except TypeError as eg: print(f"Caught TypeError group: {eg.exceptions}")

注意：return_exceptions=True 是关键，否则 gather 遇到第一个异常就停了，不会形成异常组。

python-pro

高级 Python 特性、异步编程、性能调优、静态类型、内存管理、Python 内部机制及生态库方面的专家。

下载

`except*` 的匹配逻辑和常见陷阱

它不是「只要有一个子异常匹配就进块」，而是「把所有匹配该类型的子异常打包进 eg，eg.exceptions 是 tuple，不是原始列表」。匹配后，这些子异常就从原组里剔除了，后续 except* 只看到剩下的。

多个 except* 块按顺序执行，各自独立匹配当前剩余的异常组
except* Exception 不会捕获所有 —— 它只捕获未被前面 except* 处理的、类型为 Exception 的子异常（不包括 BaseException 子类如 SystemExit）
不能混用 except 和 except* 在同一个 try 中，否则 SyntaxError
except* 块内再抛异常，会和剩余未处理子异常一起组成新 ExceptionGroup 向上传递