在Python的异常体系中,BaseException是所有异常的根基类,而Exception是BaseException的子类,绝大多数我们日常使用的内置异常比如ValueError、TypeError等都继承自Exception。自定义异常类时的继承选择,直接决定了异常的触发场景和捕获逻辑是否符合预期。
BaseException和Exception的核心区别
BaseException是所有异常的最终父类,它的子类除了Exception之外,还包括系统退出类异常:SystemExit、KeyboardInterrupt、GeneratorExit。这些异常的设计目的是用于系统层面的控制,比如用户按下Ctrl+C触发的KeyboardInterrupt,程序正常退出触发的SystemExit,通常不需要被业务代码捕获处理。
Exception则是所有业务异常的基类,我们日常开发中遇到的逻辑错误、参数错误、资源错误等都属于这个分支,也是自定义异常时最优先选择的父类。
自定义异常应该继承哪个类
绝大多数场景下,自定义异常都应该继承Exception,只有在需要定义系统级别、不希望被普通业务异常捕获逻辑处理的异常时,才考虑继承BaseException,不过这种情况非常罕见。
继承Exception的标准示例
下面是一个自定义业务异常的标准写法,继承Exception并可以添加自定义属性:
# 自定义基础业务异常,所有业务异常都继承这个类,方便统一捕获
class BusinessError(Exception):
def __init__(self, code, message):
self.code = code
self.message = message
super().__init__(self.message)
# 具体的业务异常子类
class UserNotFoundError(BusinessError):
def __init__(self, user_id):
super().__init__(code=404, message=f"用户ID为{user_id}的用户不存在")
# 使用自定义异常
def get_user(user_id):
user_list = [1, 2, 3]
if user_id not in user_list:
raise UserNotFoundError(user_id)
return {"id": user_id}
try:
get_user(5)
except BusinessError as e:
print(f"业务异常:错误码{e.code},错误信息{e.message}")
错误继承BaseException的风险
如果自定义异常继承了BaseException,会导致它不会被普通的Exception捕获逻辑处理,比如下面的错误写法:
# 错误示例:自定义异常继承BaseException
class MyError(BaseException):
pass
def test_func():
raise MyError("自定义错误")
try:
test_func()
except Exception as e:
# 这里不会捕获到MyError,因为MyError不是Exception的子类
print("捕获到异常")
上面的代码中,except Exception无法捕获MyError,很容易导致异常漏处理,引发程序非预期退出。
自定义异常的常见设计陷阱及规避方法
陷阱1:异常粒度设计不合理
很多开发者会把所有业务异常都定义成一个通用的CustomError,不区分具体错误类型,导致调用方无法针对性处理不同错误。正确的做法是按照错误类型拆分异常,比如参数错误、权限错误、资源错误分别定义不同的异常子类。
陷阱2:在异常中做过多逻辑处理
异常类的作用应该是传递错误信息,不要在__init__或者异常方法中写复杂的业务逻辑,比如查询数据库、调用外部接口等,这会让异常的触发成本变高,也不符合异常的设计初衷。
陷阱3:滥用异常代替正常流程控制
不要用异常来处理正常的业务逻辑分支,比如用异常判断用户是否存在,异常应该只用于处理不符合预期的错误场景。下面的写法是错误的:
# 错误示例:用异常做流程控制
def check_user(user_id):
if user_id < 0:
raise ValueError("用户ID不能为负")
# 正常逻辑应该返回布尔值,而不是靠是否抛异常判断
return True
# 正确写法
def check_user_correct(user_id):
return user_id >= 0
陷阱4:捕获异常后不做任何处理
捕获异常后至少要记录错误日志,或者重新抛出合适的异常,不要直接pass,否则会导致错误被隐藏,后续排查问题非常困难。
陷阱5:自定义异常没有明确的错误层级
建议先定义一个业务异常基类继承Exception,所有具体的业务异常都继承这个基类,这样调用方可以统一捕获所有业务异常,也可以单独捕获某一类具体异常,灵活性更高。可以参考下面的层级设计:
class BusinessBaseError(Exception):
"""业务异常基类"""
pass
class ParamError(BusinessBaseError):
"""参数错误异常"""
pass
class AuthError(BusinessBaseError):
"""权限错误异常"""
pass
class ResourceError(BusinessBaseError):
"""资源错误异常"""
pass
总结
自定义异常时优先选择继承Exception,除非有特殊系统级异常需求才考虑BaseException。设计时要避免粒度不合理、滥用异常、异常逻辑过重等问题,建立清晰的异常层级,才能让异常代码更易维护,也符合Python的社区规范。
自定义异常BaseExceptionException异常设计Python异常修改时间:2026-06-13 09:15:36