自定义异常怎么写？Python继承Exception类实现

Python自定义异常看似简单，实则暗藏诸多易错细节：必须显式继承Exception而非空类，抛出时务必使用raise MyError("msg")而非raise MyError，__init__中需调用super().__init__(msg)以确保可打印和调试友好，推荐统一收口至errors.py并按业务语义合理设计继承层级与携带字段；更重要的是，异常的价值不在于定义多精巧，而在于明确谁来捕获、在哪处理、传递哪些结构化信息——写之前先想清错误流与责任边界，才能让异常真正成为可靠、可维护的系统信号。

Python自定义异常必须继承 Exception，不能只写个空类

直接写 class MyError: 是无效的——它不会被 except Exception: 捕获，也不具备异常行为（比如没 __str__、不能被 raise 正常传播）。必须显式继承 Exception 或其子类（如 ValueError）。

• 推荐继承 Exception：语义清晰，业务异常就该是顶层异常的子类
• 避免继承 BaseException：那是系统级异常（如 SystemExit）的父类，业务代码不该碰
• 如果语义贴近已有类型（比如参数错得离谱），可继承 ValueError 或 TypeError，但要确保逻辑合理，别为了“省事”乱继承

抛出时用 raise MyError("msg")，不是 raise MyError

漏掉括号或参数是高频错误。写成 raise MyError 会抛出 TypeError: exceptions must derive from BaseException —— 因为 Python 把类本身当成了要抛出的对象，而类不是异常实例。

• 正确写法永远是 raise MyError("用户未登录") 或 raise MyError()（空参也行，但建议带信息）
• 如果需要传多个上下文字段（比如错误码、trace_id），在 __init__ 里接收并存为实例属性，别堆在字符串里解析
• 不要在 raise 后加 from None 除非真想屏蔽原始异常链；默认保留链路对调试更重要

加 __init__ 是为了结构化携带数据，不是为了“看起来专业”

纯消息字符串够用时，其实可以不写 __init__（Python 会自动继承父类的）。但一旦你需要把错误码、HTTP 状态码、原始输入等附带信息传出去，就必须自己实现初始化逻辑，并调用 super().__init__(...) 确保消息能被打印出来。

class UserNotFoundError(Exception):
    def __init__(self, user_id: int, source: str = "db"):
        self.user_id = user_id
        self.source = source
        super().__init__(f"User {user_id} not found in {source}")

• super().__init__(...) 这一行不能少，否则 str(exc) 为空，日志里只剩类名
• 实例属性（如 self.user_id）方便上层做条件判断：if isinstance(e, UserNotFoundError) and e.user_id == 123:
• 别在 __init__ 里做耗时操作（比如查数据库、发 HTTP 请求）——异常构造应轻量

捕获时用 except MyError: 要小心模块路径和重名

自定义异常类如果定义在不同文件、不同包里，except 时容易因导入路径不一致导致捕获失败。更隐蔽的问题是：两个同名类（比如都叫 ValidationError）来自不同模块，except ValidationError: 只会捕获你当前 import 的那个。

• 始终用完整路径导入并捕获：from myapp.errors import UserNotFoundError，然后 except UserNotFoundError:
• 避免在多处重复定义同名异常类；统一收口到 errors.py 或类似模块
• 如果要用通配捕获（比如 except Exception:），记得自定义异常必须继承 Exception，否则会被漏掉

业务异常的核心不是“怎么写类”，而是“谁负责处理它”。很多人写了漂亮异常却没人 except，或者全扔给顶层兜底，结果错误码、上下文全丢光。写之前先想清楚：这个异常预期在哪一层被捕获？需要传递哪些机器可读的字段？这些比继承语法重要得多。

理论要掌握，实操不能落！以上关于《自定义异常怎么写？Python继承Exception类实现》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！