17370845950

应使用 except* ValueError: 语法单独捕获 ExceptionGroup 中的 ValueError 子异常，因其专为遍历并匹配子异常类型设计；传统 except ValueError: 无效，因 ExceptionGroup 实例本身并非 ValueError 子类。

ExceptionGroup 中的 ValueError 怎么单独捕获

Python 3.11+ 的 ExceptionGroup 不支持直接用 except ValueError: 捕获其内部的 ValueError——因为整个异常对象是 ExceptionGroup 实例，不是 ValueError 本身。你得显式展开或检查子异常。

用 except* 语法精准匹配子异常类型

except* 是专为 ExceptionGroup 设计的语法，它会自动遍历子异常，只对匹配的类型执行处理块，并剥离已处理的部分。未被匹配的异常会继续向上抛出（或组成新的 ExceptionGroup）。

• except* ValueError: 只处理子异常中所有 ValueError 实例，不碰 TypeError 或 KeyError
• 一个 except* 块可多次触发（每个匹配的子异常一次），exc 绑定的是单个子异常，不是整个组
• 多个 except* 块按顺序尝试，互不影响；未被任何 except* 捕获的子异常会合并进外层异常

try:
    raise ExceptionGroup("mixed", [
        ValueError("bad input"),
        TypeError("wrong type"),
        ValueError("empty value")
    ])
except* ValueError as eg:
    print(f"Got {len(eg.exceptions)} ValueError(s)")
    for e in eg.exceptions:
        print(f"  → {e}")

为什么不能用传统的 except ValueError

传统 except ValueError: 判断依据是 isinstance(exc, ValueError)。而 ExceptionGroup 实例本身不是 ValueError 的子类，即使它包装了若干 ValueError ——所以该语句完全不触发。

• 错误写法：except ValueError: → 对 ExceptionGroup 无效，直接跳过
• 错误写法：except ExceptionGroup: → 能捕获，但你得手动遍历 .exceptions 并筛 ValueError，失去结构化处理优势
• 注意：except* Exception: 是合法的，但它匹配所有子异常，等价于普通 except Exception: + 手动展开，通常不推荐

实际使用时容易漏掉的关键点

except* 不是“降级 fallback”，它和普通 except 共存时有明确优先级：先跑所有 except*，再跑普通 except。如果某个子异常没被任何 except* 匹配，且整个 ExceptionGroup 也没被普通 except 捕获，就会原样冒泡。

• 必须确保至少有一个 except* 覆盖你关心的类型，否则那些异常仍会中断流程
• except* 块内不能再用 raise 抛出原 eg（会抛出空组或残留异常），如需重抛未处理部分，应显式构造新 ExceptionGroup
• 调试时打印 eg 会显示类似 ExceptionGroup(ValueError('...'), ValueError('...'))，但它的 __cause__ 和 __context__ 是 None，别指望链式追溯

真正麻烦的不是语法，而是习惯性把 ExceptionGroup 当成普通异常去 try-except——