Python异常处理从案例入门到自定义异常全解析

一、从一个案例引入：为什么需要异常处理？

写Python代码，总得面对一个现实：程序不是总能按你想象的那样顺利跑完。比如，你写了个文件读取的脚本，简简单单几行，感觉稳了——结果一执行，文件不存在，程序直接崩掉，留下一堆让人头皮发麻的红色报错。这就是典型的异常——运行时发生的错误事件，中断了正常流程。没有异常处理机制，用户看到的就只有“程序崩溃”四个字，体验极差。

咱们从最简单的场景开始感受一下：

# 尝试打开一个可能不存在的文件
file_path = "data.txt"
with open(file_path, 'r') as f:
    content = f.read()
print("文件内容：", content)

如果 data.txt 文件不存在，程序会立即崩溃，并显示类似下面的错误信息：

Traceback (most recent call last):
  File "demo.py", line 3, in 
    with open(file_path, 'r') as f:
FileNotFoundError: [Errno 2] No such file or directory: 'data.txt'

这就是一个典型的异常（Exception）。异常是程序运行时发生的错误事件，它会中断正常的程序流程。如果没有异常处理机制，程序遇到错误就会直接终止，用户体验极差。

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

Python的所有异常都继承自BaseException类。下面是主要的内置异常类层级结构：

BaseException
├── SystemExit
├── KeyboardInterrupt
├── GeneratorExit
└── Exception
    ├── StopIteration
    ├── StopAsyncIteration
    ├── ArithmeticError
    │   ├── FloatingPointError
    │   ├── OverflowError
    │   └── ZeroDivisionError
    ├── AssertionError
    ├── AttributeError
    ├── BufferError
    ├── EOFError
    ├── ImportError
    │   └── ModuleNotFoundError
    ├── LookupError
    │   ├── IndexError
    │   └── KeyError
    ├── MemoryError
    ├── NameError
    │   └── UnboundLocalError
    ├── OSError
    │   ├── FileNotFoundError
    │   ├── PermissionError
    │   └── TimeoutError
    ├── ReferenceError
    ├── RuntimeError
    │   └── NotImplementedError
    ├── SyntaxError
    │   └── IndentationError
    ├── SystemError
    ├── TypeError
    ├── ValueError
    │   └── UnicodeError
    └── Warning

理解这个层级关系很重要，因为我们可以捕获父类异常来处理多个子类异常。例如，捕获OSError可以同时处理FileNotFoundError、PermissionError等。

三、try...except：基础异常捕获

try...except是Python异常处理的核心语法：

try:
    # 可能引发异常的代码
    result = 10 / 0
except ZeroDivisionError:
    # 处理特定的异常
    print("除数不能为零！")
except (TypeError, ValueError) as e:
    # 同时处理多种异常
    print(f"类型或值错误：{e}")
except Exception as e:
    # 捕获所有其他异常（不推荐在生产代码中滥用）
    print(f"发生未知错误：{e}")
else:
    # 如果没有异常发生，执行这里的代码
    print("计算成功！")
finally:
    # 无论是否发生异常，都会执行
    print("清理资源...")

四、打印异常信息：获取详细错误

我们可以通过多种方式获取异常的详细信息：

import traceback
try:
    x = 1 / 0
except ZeroDivisionError as e:
    # 1. 异常对象本身
    print(f"异常对象：{e}")
    # 2. 异常类型
    print(f"异常类型：{type(e).__name__}")
    # 3. 完整的异常信息
    print(f"完整信息：{traceback.format_exc()}")
    # 4. 异常参数（如果有）
    print(f"异常参数：{e.args}")

五、try-except-else-finally：完整形式

这四个关键词可以组合使用，形成完整的异常处理流程：

def read_file_safely(filename):
    """安全读取文件的示例"""
    content = None
    try:
        print(f"尝试打开文件：{filename}")
        with open(filename, 'r') as f:
            content = f.read()
    except FileNotFoundError:
        print(f"文件 {filename} 不存在")
    except PermissionError:
        print(f"没有权限读取文件 {filename}")
    except OSError as e:
        print(f"系统错误：{e}")
    else:
        print("文件读取成功！")
        return content
    finally:
        print("文件操作结束，清理完成")
    return content
测试
result = read_file_safely("data.txt")
if result:
print(f"读取到 {len(result)} 个字符")

执行顺序：

1. 执行try块中的代码
2. 如果发生异常，跳转到匹配的except块
3. 如果没有异常，执行else块
4. 无论是否发生异常，最后都执行finally块

六、抛出异常：主动引发错误

我们可以使用raise语句主动抛出异常：

def validate_age(age):
    """验证年龄是否合法"""
    if not isinstance(age, int):
        raise TypeError("年龄必须是整数")
    if age < 0:
        raise ValueError("年龄不能为负数")
    if age > 150:
        raise ValueError("年龄不能超过150岁")
    return True
测试
try:
validate_age(-5)
except ValueError as e:
print(f"验证失败：{e}")

七、自定义异常：创建业务异常类

通过继承Exception类，我们可以创建自定义异常：

class InsufficientFundsError(Exception):
    """余额不足异常"""
    def __init__(self, balance, amount):
        self.balance = balance
        self.amount = amount
        message = f"余额不足！当前余额：{balance}，需要：{amount}"
        super().__init__(message)
class BankAccount:
def init(self, balance):
self.balance = balance
def withdraw(self, amount):
    if amount > self.balance:
        raise InsufficientFundsError(self.balance, amount)
    self.balance -= amount
    return self.balance
使用自定义异常
account = BankAccount(1000)
try:
account.withdraw(1500)
except InsufficientFundsError as e:
print(f"取款失败：{e}")
print(f"详细信息：余额={e.balance}, 请求={e.amount}")

八、异常的传递：不捕获时的行为

当异常没有被捕获时，它会沿着调用栈向上传递：

def function_a():
    print("函数A开始")
    function_b()
    print("函数A结束")  # 这行不会执行
def function_b():
print("函数B开始")
function_c()
print("函数B结束")  # 这行不会执行
def function_c():
print("函数C开始")
raise ValueError("函数C中发生错误")
print("函数C结束")  # 这行不会执行
调用链
try:
function_a()
except ValueError as e:
print(f"在最外层捕获到异常：{e}")
print("异常传递路径：function_c → function_b → function_a → 主程序")

异常传递的特点：

• 异常会从发生点开始，沿着调用栈向上传递
• 每个函数都可以选择捕获或继续传递异常
• 如果没有任何函数捕获，程序最终会崩溃并显示完整的调用栈信息
• 使用traceback模块可以查看详细的调用路径

九、最佳实践与常见陷阱

最佳实践：

• 具体异常优先：尽量捕获具体的异常类型，而不是通用的Exception
• 避免空except：不要使用except:（会捕获所有异常，包括KeyboardInterrupt）
• 记录异常信息：在生产环境中记录异常的详细信息
• 资源清理：使用finally或上下文管理器确保资源被正确释放
• 自定义异常：为业务逻辑创建有意义的自定义异常

常见陷阱：

陷阱1：过于宽泛的异常捕获

try:
    # 业务代码
    pass
except:  # 错误：会捕获所有异常，包括SystemExit
    pass

陷阱2：吞掉异常信息

try:
    risky_operation()
except Exception:
    pass  # 错误：完全不知道发生了什么

陷阱3：在finally中return

def bad_example():
    try:
        return 1
    finally:
        return 2  # 这个返回值会覆盖try中的返回值
result = bad_example()  # 结果是2，不是1

十、总结

Python的异常处理机制提供了强大的错误管理能力：

1. 基础语法：try-except-else-finally四件套
2. 异常层级：理解内置异常的继承关系有助于精确捕获
3. 信息获取：通过traceback等工具获取详细错误信息
4. 主动抛出：使用raise在适当的时候引发异常
5. 自定义异常：创建符合业务需求的异常类
6. 异常传递：理解异常在调用栈中的传播机制

合理的异常处理不仅能提高程序的健壮性，还能让代码更清晰、更易于维护。记住：异常处理的目标不是消灭所有异常，而是优雅地处理那些预期内可能发生的错误。