从基础语法到工程级实践解析Python错误处理的完整指南

# demo_basic_exception.py
# 演示基本的 try-except 结构

def safe_division():
    try:
        # 模拟用户输入
        numerator = 10
        denominator = 0
        
        # 核心计算逻辑
        result = numerator / denominator
        print(f"计算结果是: {result}")
        
    except ZeroDivisionError as e:
        # 专门处理除零错误
        print(f"捕获到数学错误: 不能除以零。详细信息: {e}")
    except TypeError as e:
        # 专门处理类型错误
        print(f"捕获到类型错误: 输入必须是数字。详细信息: {e}")

if __name__ == "__main__":
    safe_division()

# demo_raise_exception.py
# 演示如何使用 raise 主动抛出异常

def validate_age(age):
    """
    验证年龄是否合法。
    如果不合法，主动抛出异常。
    """
    if not isinstance(age, int):
        # 主动抛出类型错误
        raise TypeError("年龄必须是一个整数")
    
    if age < 0 or age > 150:
        # 主动抛出值错误
        raise ValueError("年龄必须在 0 到 150 之间")
    
    return True

# 测试代码
if __name__ == "__main__":
    try:
        # 测试非法年龄
        validate_age(200)
    except ValueError as e:
        print(f"验证失败: {e}")
    except TypeError as e:
        print(f"类型错误: {e}")

# demo_custom_exception.py
# 演示自定义异常类及其使用

class InsufficientFundsError(Exception):
    """自定义异常：余额不足"""
    def __init__(self, balance, amount_needed):
        self.balance = balance
        self.amount_needed = amount_needed
        self.shortage = amount_needed - balance
        # 调用父类的初始化方法
        super().__init__(f"余额不足。当前: ${balance}, 需要: ${amount_needed}")

def process_purchase(balance, price):
    """处理购买逻辑"""
    if balance < price:
        # 抛出自定义异常
        raise InsufficientFundsError(balance, price)
    return balance - price

# 测试代码
if __name__ == "__main__":
    try:
        remaining = process_purchase(50, 100)
        print(f"购买成功，剩余: {remaining}")
    except InsufficientFundsError as e:
        print(f"交易失败: {e}")
        print(f"还差 ${e.shortage} 元")

# demo_try_finally.py
# 演示 try-finally 确保资源清理

def read_config_file(filename):
    """模拟读取配置文件，确保文件关闭"""
    file_handle = None
    print(f"尝试打开文件: {filename}")
    
    try:
        # 模拟打开文件
        file_handle = open(filename, 'r')
        # 模拟读取内容
        content = file_handle.read()
        return content
    except FileNotFoundError:
        print("文件未找到，返回默认配置。")
        return "default_config"
    finally:
        # 这一步总是会执行
        print("进入 finally 代码块...")
        if file_handle:
            file_handle.close()
            print("文件已成功关闭。")
        else:
            print("文件句柄为空，无需关闭。")

# 测试代码
if __name__ == "__main__":
    # 测试文件不存在的情况
    read_config_file("non_existent_config.txt")

# demo_exception_chaining.py
# 演示异常链和完整的 try-except-else-finally 结构

import json

def parse_user_data(json_string):
    """
    解析用户数据，展示完整的错误处理流程。
    """
    result = None
    try:
        # 第一步：解析 JSON
        data = json.loads(json_string)
        
        # 第二步：提取关键字段
        user_id = data['id']
        username = data['name']
        
    except json.JSONDecodeError as e:
        # 如果是 JSON 格式错误，包装成更友好的错误
        raise ValueError("用户数据格式损坏") from e
        
    except KeyError as e:
        # 如果是缺少字段，同样包装
        raise ValueError(f"缺少关键字段: {e}") from None
        
    else:
        # 只有 try 块完全成功，才会执行这里
        print("JSON 解析成功，无异常发生。")
        result = f"User: {username} (ID: {user_id})"
        return result
        
    finally:
        # 无论成功还是失败，都会执行
        print("解析流程结束，清理临时变量。")

# 测试代码
if __name__ == "__main__":
    valid_json = '{"id": 101, "name": "Alice"}'
    invalid_json = '{"id": 102, "username": "Bob"}'  # 缺少 'name'

    print("--- 测试有效数据 ---")
    try:
        print(parse_user_data(valid_json))
    except Exception as e:
        print(f"捕获到异常: {e}")

    print("\n--- 测试无效数据 ---")
    try:
        print(parse_user_data(invalid_json))
    except Exception as e:
        print(f"捕获到异常: {e}")
        # 打印异常链的原始原因
        if e.__cause__:
            print(f"根本原因: {e.__cause__}")

# demo_math_validation.py
# 演示结合数学公式的错误处理

import math

def calculate_circle_area(radius):
    """
    计算圆的面积。
    公式: $S = \pi r^2$
    """
    if radius < 0:
        # 半径不能为负数
        raise ValueError(f"半径 $r$ 不能为负数，当前值为 {radius}")
    
    if not isinstance(radius, (int, float)):
        raise TypeError("半径必须是数值类型")
    
    # 计算面积
    area = math.pi * (radius ** 2)
    return area

# 测试代码
if __name__ == "__main__":
    try:
        # 测试负半径
        area = calculate_circle_area(-5)
        print(f"面积: {area}")
    except ValueError as e:
        print(f"计算失败: {e}")
        print("请确保公式 $S = \pi r^2$ 中的 $r > 0$。")

# demo_context_manager.py
# 演示使用上下文管理器替代 try-finally

class DatabaseConnection:
    """模拟数据库连接"""
    
    def __enter__(self):
        # 进入 with 代码块时执行
        print("建立数据库连接...")
        return self
    
    def __exit__(self, exc_type, exc_val, exc_tb):
        # 退出 with 代码块时执行（无论是否有异常）
        print("关闭数据库连接。")
        # 如果返回 True，则异常会被抑制；返回 False，异常会继续传播
        return False
    
    def query(self, sql):
        print(f"执行 SQL: {sql}")

# 测试代码
if __name__ == "__main__":
    print("开始数据库操作...")
    try:
        with DatabaseConnection() as db:
            # 这里的代码在 try 块中
            db.query("SELECT * FROM users;")
            # 模拟一个错误
            # raise RuntimeError("查询失败")
    except RuntimeError:
        print("捕获到运行时错误。")
    print("数据库操作结束。")