Python案例怎么自定义异常类？

wen python案例 2026-06-11 13

Python案例：如何自定义异常类？从零到精通的完整指南

目录导读

什么是异常？为什么需要自定义异常？
Python内置异常体系回顾
自定义异常类的语法与核心要点
实战案例1：电商库存系统异常类设计
实战案例2：用户输入验证异常
实战案例3：网络请求超时与重试异常
自定义异常的继承链与层次设计
如何优雅地抛出与捕获自定义异常？
常见错误与最佳实践
问答环节：高频疑问精解

什么是异常？为什么需要自定义异常？

在Python中，异常（Exception）是程序运行时发生的错误，当你试图打开一个不存在的文件、除以零或访问列表越界索引时，Python会抛出内置异常如FileNotFoundError、ZeroDivisionError或IndexError。

Python案例怎么自定义异常类？

但为什么我们要自定义异常？

原因很简单：内置异常不够“语义化”，假设你开发一款图书管理系统，当用户试图借阅一本已经借出的书时，抛出ValueError虽然能阻止程序崩溃，但其他开发者无法一眼看出这是“借阅冲突”而非“参数类型错误”，自定义异常如BookAlreadyBorrowedError能让错误意图一目了然,极大提升代码可读性与维护性。

场景举例：

电商系统：库存不足、支付失败、优惠券过期
数据管道：数据格式异常、连接超时、校验失败
游戏开发：角色血量不足、技能冷却中、非法操作

Python内置异常体系回顾

要自定义异常，必须先了解Python的异常继承树，所有异常都继承自BaseException，但实际开发中我们仅继承Exception或其子类：

BaseException
├── SystemExit
├── KeyboardInterrupt
├── GeneratorExit
└── Exception
    ├── StopIteration
    ├── ArithmeticError
    │   └── ZeroDivisionError
    ├── LookupError
    │   ├── IndexError
    │   └── KeyError
    └── ValueError, TypeError, OSError ...

关键规则： 自定义异常类必须直接或间接继承Exception，不要继承BaseException,否则可能会干扰系统退出或键盘中断的处理。

自定义异常类的语法与核心要点

1 基础语法

class MyCustomError(Exception):
    """这是我自定义的异常说明"""
    pass

仅仅如此，你就拥有了一个功能完备的自定义异常，它继承了Exception的所有行为：可以被raise、被except捕获、打印堆栈信息。

2 添加自定义属性与init

有时你需要传递更多信息（如错误码、异常详情）：

class StockShortageError(Exception):
    def __init__(self, product_id, requested_qty, available_qty):
        self.product_id = product_id
        self.requested_qty = requested_qty
        self.available_qty = available_qty
        self.message = f"商品{product_id}库存不足：需要{requested_qty}，仅剩{available_qty}"
        super().__init__(self.message)

捕获异常时可以直接访问e.product_id,便于日志记录或触发补货流程。

3 重写str

如果你想自定义打印信息，可以重写__str__：

class InvalidAgeError(Exception):
    def __str__(self):
        return f"年龄必须在0-150之间，当前值：{self.args[0]}"

实战案例1：电商库存系统异常类设计

需求： 模拟电商下单场景，用户下单时检查库存，若不足则抛出自定义异常，且支持传递商品ID、请求数量、可用数量。

代码实现：

class StockShortageError(Exception):
    def __init__(self, product_id, requested_qty, available_qty):
        self.product_id = product_id
        self.requested_qty = requested_qty
        self.available_qty = available_qty
        self.message = f"商品[{product_id}]库存不足: 请求{requested_qty}件, 可用{available_qty}件"
        super().__init__(self.message)
def place_order(product_id, qty):
    # 模拟库存数据
    stock = {"A001": 10, "A002": 0, "A003": 50}
    available = stock.get(product_id, 0)
    if qty > available:
        raise StockShortageError(product_id, qty, available)
    print(f"下单成功：{product_id} x {qty}")
# 调用
try:
    place_order("A002", 1)
except StockShortageError as e:
    print(f"错误：{e}")  # 输出：商品[A002]库存不足: 请求1件, 可用0件
    print(f"商品ID: {e.product_id}")  # 可用于后续自动补货逻辑

优势： 错误信息清晰，且保留了结构化数据,便于程序自动处理。

实战案例2：用户输入验证异常

需求： 注册页面验证用户输入，年龄必须为整数且在0-150之间，邮箱必须包含“@”和“.”。

代码实现：

class ValidationError(Exception):
    """基础验证异常"""
    pass
class InvalidAgeError(ValidationError):
    def __init__(self, age):
        self.age = age
        super().__init__(f"无效年龄 '{age}': 必须为0-150的整数")
class InvalidEmailError(ValidationError):
    def __init__(self, email):
        self.email = email
        super().__init__(f"无效邮箱 '{email}': 缺少@或.")
def validate_user(name, age, email):
    if not isinstance(age, int) or age < 0 or age > 150:
        raise InvalidAgeError(age)
    if "@" not in email or "." not in email:
        raise InvalidEmailError(email)
    print(f"用户 {name} 验证通过")
# 测试
try:
    validate_user("张三", 25, "zhangsan@example.com")  # 正常
    validate_user("李四", -5, "lisi.at.com")  # 触发异常
except InvalidAgeError as e:
    print(f"年龄错误：{e}")
except InvalidEmailError as e:
    print(f"邮箱错误：{e}")

设计亮点： 使用基类ValidationError，后续可以添加更多验证异常（如密码强度、手机号格式），并在except ValidationError中统一处理。

实战案例3：网络请求超时与重试异常

需求： 模拟HTTP请求，当请求超时时抛出RequestTimeoutError，如果连续重试3次均超时抛出MaxRetriesExceededError。

代码实现：

class RequestTimeoutError(Exception):
    def __init__(self, url, timeout_sec):
        self.url = url
        self.timeout_sec = timeout_sec
        super().__init__(f"请求 {url} 超时（{timeout_sec}秒）")
class MaxRetriesExceededError(Exception):
    def __init__(self, url, retries):
        self.url = url
        self.retries = retries
        super().__init__(f"对 {url} 重试{retries}次后仍然失败")
import time
def fetch_url(url, timeout=2, max_retries=3):
    for attempt in range(1, max_retries + 1):
        try:
            # 模拟网络请求，随机超时
            if url == "http://slow.example.com" and attempt < 3:
                time.sleep(3)  # 模拟超时
                raise RequestTimeoutError(url, timeout)
            print(f"第{attempt}次请求成功：{url}")
            return
        except RequestTimeoutError:
            if attempt == max_retries:
                raise MaxRetriesExceededError(url, max_retries)
            print(f"第{attempt}次超时，准备重试...")
            time.sleep(1)
# 测试
try:
    fetch_url("http://slow.example.com")
except MaxRetriesExceededError as e:
    print(f"最终失败：{e}")

工程价值： 通过异常传递重试上下文（尝试次数、URL）,便于日志分析和告警。

自定义异常的继承链与层次设计

好的异常层次设计可以极大简化错误处理。

建议采用“基类-子类”两级结构：

基类：AppBaseError（继承Exception）,用于应用层通用捕获。
子类：具体业务异常，如DatabaseError、NetworkError、ValidationError。

示例：

class AppError(Exception):
    """应用基础异常"""
    def __init__(self, code=500, message="应用内部错误"):
        self.code = code
        self.message = message
        super().__init__(self.message)
class DatabaseError(AppError):
    def __init__(self, detail="数据库操作失败"):
        super().__init__(code=500, message=detail)
class UserNotFoundError(DatabaseError):
    def __init__(self, user_id):
        super().__init__(f"用户 {user_id} 不存在")
        self.user_id = user_id

捕获技巧： 使用except AppError可以捕获所有应用内定义的异常，而不会干扰KeyboardInterrupt等系统异常。

如何优雅地抛出与捕获自定义异常？

1 抛出异常 —— 使用raise

raise StockShortageError("A001", 5, 2)

2 异常链 —— 保留原异常

try:
    1 / 0
except ZeroDivisionError as e:
    raise MyCustomError("除法异常") from e
# 打印时显示：MyCustomError: 除法异常 也被 ZeroDivisionError: division by zero

3 多重捕获

try:
    process()
except (StockShortageError, ValidationError) as e:
    print(f"业务异常：{e}")
except AppError as e:
    print(f"通用应用异常：{e.code} - {e.message}")

4 使用finally确保资源释放

file = open("data.txt")
try:
    process_file(file)
except MyCustomError:
    print("处理异常")
finally:
    file.close()

常见错误与最佳实践

错误做法	正确做法
继承`BaseException`	继承`Exception`或其子类
自定义异常中没有添加`__init__`	根据需要传递上下文数据
捕获所有异常`except:`	尽量精确捕获，或使用`except Exception`
忽略异常不处理	至少记录日志
异常类名不以`Error`或`Exception`	使用清晰后缀，如`StockShortageError`