自定义异常类仅继承exception不够，必须确保可实例化且args非空、结构正常，才能被exceptiongroup安全包裹和except*捕获。
自定义异常类继承 Exception 就够了吗？
不够。在 Python 3.11 中，ExceptionGroup 是为批量异常设计的新基类，它和普通异常（如 ValueError）不在同一继承体系里。如果你的自定义异常要被 ExceptionGroup 包裹、参与 except* 捕获，或自身需作为子组存在，就必须显式兼容——不是靠继承 Exception，而是确保能被 ExceptionGroup 正确归类和展开。
ExceptionGroup 对自定义异常的唯一要求是“可实例化且不阻断遍历”
Python 3.11 的 ExceptionGroup 在构造时会尝试调用 args 中每个异常的 __cause__ 和 __traceback__ 属性，并在 except* 中按类型匹配子异常。只要你的自定义异常：
- 继承自
BaseException（即所有异常的根，Exception已满足） - 不重写
__init__导致args为空或结构异常（例如把*args吞掉却不存为self.args） - 不主动 raise 自身导致构造中断（比如在
__init__里抛出另一个异常）
它就能被 ExceptionGroup 安全包裹。下面是最小可行示例：
class MyNetworkError(Exception):
def __init__(self, host: str, port: int, reason: str):
# 必须显式构造 args 元组，否则 ExceptionGroup 无法提取消息
super().__init__(f"Connection failed to {host}:{port} — {reason}")
self.host = host
self.port = port
self.reason = reason
<h1>✅ 可直接用于 ExceptionGroup</h1><p>eg = ExceptionGroup("network failures", [
MyNetworkError("api.example.com", 443, "timeout"),
MyNetworkError("db.internal", 5432, "refused")
])</p><h1>✅ 可被 except* 按类型捕获</h1><p>try:
raise eg
except* MyNetworkError as eg2:
print(f"Caught {len(eg2.exceptions)} network errors")
</p>
为什么重写 __str__ 或 __repr__ 会导致 except* 失效？
不会直接失效，但会影响调试体验和日志可读性。真正危险的是修改 args 的结构或语义：
- 如果
__init__中没调用super().__init__(...)，self.args为空 →ExceptionGroup构造时可能静默跳过该异常，或在except*中因类型匹配但无 message 而难以定位 - 如果把
*args存成self._raw_args却没赋给self.args→ExceptionGroup无法获取原始参数，str(exc)返回空字符串 - 如果在
__init__中 raise 新异常（如校验失败抛ValueError）→ 整个ExceptionGroup构造失败，报TypeError: exceptions must be BaseException instances
所以核心原则只有一条：让 self.args 保持可用、非空、与预期一致。
需要嵌套 ExceptionGroup 时，自定义类该怎么设计？
不需要特殊设计。ExceptionGroup 本身是 BaseException 子类，因此可以作为其他 ExceptionGroup 的子异常，也可以混在普通异常中。你只需确保自定义异常不干扰这一链路：
- 避免在自定义异常的
__init__中递归构造深层ExceptionGroup（容易栈溢出） - 若需携带子组，推荐用字段显式存储（如
self.nested_group），而非试图“伪装”成ExceptionGroup实例 - 不要继承
ExceptionGroup来做自定义——它被设计为不可继承（__init__是冻结的，且文档明确不鼓励子类化）
例如，处理分片请求失败时，可这样组织：
class ShardFailure(Exception):
def __init__(self, shard_id: int, cause: BaseException):
super().__init__(f"Shard {shard_id} failed: {cause}")
self.shard_id = shard_id
self.cause = cause # 保留原始异常，包括可能是 ExceptionGroup
<h1>组合使用</h1><p>inner_eg = ExceptionGroup("shard-0 errors", [TimeoutError(), ConnectionError()])
outer = ExceptionGroup("query failed", [
ShardFailure(0, inner_eg),
ShardFailure(1, OSError("disk full"))
])
</p>
这种结构完全合法，且 except* ShardFailure 和 except* TimeoutError 都能正常工作。
最易被忽略的一点：Python 3.11 的 ExceptionGroup 不检查自定义异常的任何额外属性，只依赖 isinstance(exc, TargetType) 和 exc.args。所以哪怕你加了 __cause__、add_note() 或自定义序列化方法，只要不破坏这两点，就始终安全。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
