Python自定义异常怎么写_继承Exception类抛出业务专属报错

Python自定义异常必须继承Exception或其子类，否则无法被except 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__(...) 确保消息能被打印出来。

Media.io

多功能的AI视频和图像处理平台

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，或者全扔给顶层兜底，结果错误码、上下文全丢光。写之前先想清楚：这个异常预期在哪一层被捕获？需要传递哪些机器可读的字段？这些比继承语法重要得多。