Python异常处理实战：try-except到自定义异常类

脚本专家

Python的异常处理是编写健壮代码的核心技能。本文从实际案例出发，系统讲解try-except、异常层级、主动抛出异常、自定义异常及异常传递等知识点，并给出最佳实践和常见陷阱。

一、从文件读取错误看异常处理

假设我们要读取一个文件：

2. file_path = "data.txt"
3. with open(file_path, 'r') as f:
4.     content = f.read()
5.     print("文件内容：", content)

复制代码

如果data.txt不存在，程序会直接崩溃并抛出FileNotFoundError。异常（Exception）是运行时发生的错误事件，会中断正常流程。没有异常处理，程序遇到错误就终止，用户体验极差。

二、Python内置异常的层级关系

所有异常都继承自BaseException。主要层级如下：
- BaseException
  - SystemExit
  - KeyboardInterrupt
  - GeneratorExit
  - Exception（绝大多数业务异常在此）
    - StopIteration
    - ArithmeticError (FloatingPointError, OverflowError, ZeroDivisionError)
    - AssertionError
    - AttributeError
    - EOFError
    - ImportError (ModuleNotFoundError)
    - LookupError (IndexError, KeyError)
    - NameError (UnboundLocalError)
    - OSError (FileNotFoundError, PermissionError, TimeoutError)
    - RuntimeError (NotImplementedError)
    - SyntaxError (IndentationError)
    - TypeError
    - ValueError (UnicodeError)
    - 以及其他Warning等

理解层级关系有助于精确捕获。例如捕获OSError可以同时处理FileNotFoundError和PermissionError。

三、try...except的三种捕获方式

基础语法：

2. try:
3.     result = 10 / 0
4. except ZeroDivisionError:
5.     print("除数不能为零！")
6. except (TypeError, ValueError) as e:
7.     print(f"类型或值错误：{e}")
8. except Exception as e:
9.     print(f"发生未知错误：{e}")

复制代码

建议优先捕获具体异常，避免笼统捕获Exception。

四、获取异常详细信息的四种方法

通过traceback模块可以获取完整栈信息：

2. import traceback
3. try:
4.     x = 1 / 0
5. except ZeroDivisionError as e:
6.     print(f"异常对象：{e}")                     # 1
7.     print(f"异常类型：{type(e).__name__}")      # 2
8.     print(f"完整信息：{traceback.format_exc()}")  # 3
9.     print(f"异常参数：{e.args}")                # 4

复制代码

五、try-except-else-finally完整流程

2. def read_file_safely(filename):
3.     content = None
4.     try:
5.         print(f"尝试打开文件：{filename}")
6.         with open(filename, 'r') as f:
7.             content = f.read()
8.     except FileNotFoundError:
9.         print(f"文件 {filename} 不存在")
10.     except PermissionError:
11.         print(f"没有权限读取文件 {filename}")
12.     except OSError as e:
13.         print(f"系统错误：{e}")
14.     else:
15.         print("文件读取成功！")
16.         return content
17.     finally:
18.         print("文件操作结束，清理完成")
19.         return content  # 注意：finally中的return会覆盖else中的return
21. result = read_file_safely("data.txt")

复制代码

执行顺序：try → 命中except → else（无异常时） → finally。注意finally块中的return会覆盖前面的返回值，这是常见陷阱。

六、使用raise主动抛出异常

2. def validate_age(age):
3.     if not isinstance(age, int):
4.         raise TypeError("年龄必须是整数")
5.     if age < 0:
6.         raise ValueError("年龄不能为负数")
7.     if age > 150:
8.         raise ValueError("年龄不能超过150岁")
9.     return True
11. try:
12.     validate_age(-5)
13. except ValueError as e:
14.     print(f"验证失败：{e}")

复制代码

raise可以附带自定义消息，也可在except块中重新抛出异常。

七、自定义异常类

继承Exception，添加业务属性：

2. class InsufficientFundsError(Exception):
3.     def __init__(self, balance, amount):
4.         self.balance = balance
5.         self.amount = amount
6.         message = f"余额不足！当前余额：{balance}，需要：{amount}"
7.         super().__init__(message)
9. class BankAccount:
10.     def __init__(self, balance):
11.         self.balance = balance
13.     def withdraw(self, amount):
14.         if amount > self.balance:
15.             raise InsufficientFundsError(self.balance, amount)
16.         self.balance -= amount
17.         return self.balance
19. account = BankAccount(1000)
20. try:
21.     account.withdraw(1500)
22. except InsufficientFundsError as e:
23.     print(f"取款失败：{e}")
24.     print(f"余额={e.balance}, 请求={e.amount}")

复制代码

自定义异常使错误语义更清晰，便于调用方进行精确处理。

八、异常的传递机制

异常未捕获时会沿调用栈向上传递：

2. def function_a():
3.     print("函数A开始")
4.     function_b()
5.     print("函数A结束")  # 不会执行
7. def function_b():
8.     print("函数B开始")
9.     function_c()
10.     print("函数B结束")  # 不会执行
12. def function_c():
13.     print("函数C开始")
14.     raise ValueError("函数C中发生错误")
15.     print("函数C结束")  # 不会执行
17. try:
18.     function_a()
19. except ValueError as e:
20.     print(f"在最外层捕获到异常：{e}")
21.     print("传递路径：function_c → function_b → function_a → 主程序")

复制代码

异常传递特点：从发生点向上传播，每层都可选择捕获或继续抛出；若最终无捕获，程序崩溃并显示完整调用栈。

九、最佳实践与常见陷阱

最佳实践：
- 优先捕获具体异常类
- 避免空except:（会捕获KeyboardInterrupt等）
- 在生产环境记录异常详情
- 使用finally或with确保资源释放
- 为业务逻辑创建自定义异常

常见陷阱：
1. 过于宽泛的捕获：except: 会吞掉SystemExit等
2. 吞掉异常信息：直接pass而不记录
3. finally中return覆盖try/else中的return值

十、总结

异常处理不是消灭所有错误，而是优雅地处理预期内的异常。掌握try-except-else-finally、异常层级、raise、自定义异常及传递机制，能显著提升代码的健壮性和可维护性。

热心网友4

感谢楼主分享这么详细的异常处理教程！从基础语法到自定义异常，内容非常系统，特别是用文件读取作为切入点，特别贴近实际开发。我有两个地方特别有共鸣： 1. 你对`finally`中return会覆盖其他return的提醒很关键，这个陷阱我早期踩过很多次。 2. 自定义异常类的示例也很实用，带业务属性的异常比纯字符串信息可读性强太多了。 想请教一个点：在处理多层嵌套的异常时，你一般是逐层捕获并转换，还是更喜欢用`raise ... from`保留原始上下文？我个人倾向于后者，但有时候为了调用方方便，又直接包装成业务异常。不知道你对这两种方式的使用场景有什么建议？

热心网友4

感谢楼主分享这么详细的异常处理教程！特别是 `finally` 中 `return` 覆盖这个陷阱，我以前踩过坑，看完才明白原因。另外自定义异常类那段例子很好，我平时写业务逻辑时总想着用通用异常，后来发现自定义异常能让调用方更明确地处理问题。不过有个小疑问：在 except 块中重新抛出异常（比如 `raise` 不带参数）和直接 `raise e` 有什么区别吗？希望楼主能再讲讲这个细节。

热心网友4

楼主的分享非常全面！之前一直对异常层级和自定义异常这部分有点模糊，看了之后清晰多了。尤其是那个 finally 里 return 的陷阱，以前没注意过，差点踩坑。感谢整理！