Python异常处理最佳实践指南

try:withopen("data.txt", "r") as f:        content = f.read()except:  # 裸 except，捕获所有异常，包括 KeyboardInterrupt、SystemExit 等print("出错了")

try:withopen("data.txt", "r") as f:        content = f.read()except FileNotFoundError:print("文件不存在，检查路径是否正确")except PermissionError:print("没有读取权限")except IOError as e:print(f"读取文件时发生IO错误: {e}")

• • 当你确切知道可能发生哪些异常时
• • 需要对不同类型的异常做不同处理
• • 避免意外捕获 KeyboardInterrupt（Ctrl+C）等系统级异常

try:    result = risky_operation()# 如果没有异常，继续处理    processed = process_result(result)except SomeError:    handle_error()

try:    result = risky_operation()except SomeError:    handle_error()else:# 只有 risky_operation 成功时才执行    processed = process_result(result)

• • 需要区分“操作成功”和“成功后的处理”
• • 避免异常处理范围过大
• • 让代码逻辑更清晰

file = open("data.txt", "r")try:    data = file.read()    process(data)except IOError:print("读取失败")# 如果这里发生异常，file 可能不会被关闭file.close()

file = open("data.txt", "r")try:    data = file.read()    process(data)except IOError:print("读取失败")finally:    file.close()  # 无论是否发生异常，都会执行

• • 任何需要确保清理操作的场景
• • 即使发生异常也不能忘记的收尾工作

file = Nonetry:    file = open("data.txt", "r")    data = file.read()except IOError:print("读取失败")finally:if file:        file.close()

withopen("data.txt", "r") as file:    data = file.read()# 离开 with 块后，文件会自动关闭，即使发生异常也不例外

• • 任何实现了上下文管理器协议（__enter__ 和 __exit__ 方法）的对象
• • 文件操作、数据库连接、线程锁、临时目录等

from contextlib import contextmanager@contextmanagerdefdatabase_connection(connection_string):    conn = create_connection(connection_string)try:yield connfinally:        conn.close()# 使用with database_connection("mysql://user:pass@localhost/db") as conn:    results = conn.execute_query("SELECT * FROM users")

defprocess_user(user_id):    user = get_user(user_id)ifnot user:raise ValueError("用户不存在")  # 不够明确if user.age < 18:raise ValueError("用户未成年")  # 与上面的 ValueError 无法区分

classUserNotFoundError(Exception):"""用户不存在异常"""passclassUnderageUserError(Exception):"""用户未成年异常"""passdefprocess_user(user_id):    user = get_user(user_id)ifnot user:raise UserNotFoundError(f"用户ID {user_id} 不存在")if user.age < 18:raise UnderageUserError(f"用户 {user_id} 未成年，年龄 {user.age}")

• • 应用程序有特定的业务逻辑错误
• • 需要区分不同类型的错误以便不同处理
• • 提高代码可读性和可维护性

1. 1. 异常名以 Error 结尾
2. 2. 继承自 Exception 或其子类
3. 3. 提供有意义的错误信息
4. 4. 考虑异常层级结构（比如 ValidationError 可以有 EmailValidationError、PasswordValidationError 等子类）

try:    parse_config("config.yaml")except YAMLError:raise ConfigError("配置文件解析失败")  # 原始 YAMLError 信息丢失了

try:    parse_config("config.yaml")except YAMLError as e:raise ConfigError("配置文件解析失败") from e

try:# 一些操作passexcept ConfigError as e:print(f"当前异常: {e}")if e.__cause__:print(f"原始异常: {e.__cause__}")

• • 包装底层异常为高层异常时
• • 需要保留完整的错误上下文链
• • 调试复杂的多层调用

try:    process_payment(user, amount)except PaymentError:print("支付失败")  # 控制台输出，无法持久化，信息太少

import logginglogger = logging.getLogger(__name__)try:    process_payment(user, amount)except PaymentError as e:    logger.error(f"支付处理失败: 用户={user.id}, 金额={amount}", exc_info=True)# exc_info=True 会记录完整的异常回溯信息raise# 根据情况决定是否重新抛出

• • logger.debug(): 详细的调试信息，包括变量值
• • logger.info(): 正常的业务操作记录
• • logger.warning(): 不严重的问题，但需要注意
• • logger.error(): 错误情况，需要调查
• • logger.critical(): 严重错误，可能导致系统无法运行

• • 任何生产环境代码
• • 需要监控和诊断的问题
• • 审计和合规要求

defprocess_order(order):try:# 验证订单ifnot order.is_valid():raise ValidationError("订单无效")# 检查库存try:            check_inventory(order.items)except InventoryError:raise OrderError("库存不足")# 处理支付try:            process_payment(order)except PaymentError:raise OrderError("支付失败")# 更新订单状态        update_order_status(order, "completed")except ValidationError as e:        logger.error(f"订单验证失败: {e}")return {"success": False, "error": str(e)}except OrderError as e:        logger.error(f"订单处理失败: {e}")return {"success": False, "error": str(e)}except Exception as e:        logger.error(f"未知错误: {e}")return {"success": False, "error": "系统内部错误"}

from functools import wrapsdefhandle_order_errors(func):    @wraps(func)defwrapper(*args, **kwargs):try:return func(*args, **kwargs)except ValidationError as e:            logger.error(f"订单验证失败: {e}")return {"success": False, "error": str(e)}except OrderError as e:            logger.error(f"订单处理失败: {e}")return {"success": False, "error": str(e)}except Exception as e:            logger.error(f"未知错误: {e}")return {"success": False, "error": "系统内部错误"}return wrapper# 业务逻辑变得清晰@handle_order_errorsdefprocess_order(order):# 验证订单ifnot order.is_valid():raise ValidationError("订单无效")# 检查库存    check_inventory(order.items)  # 可能抛出 InventoryError# 处理支付    process_payment(order)  # 可能抛出 PaymentError# 更新订单状态    update_order_status(order, "completed")return {"success": True}

• • 复杂的业务逻辑需要统一的错误处理
• • 多个函数有相似的异常处理模式
• • 希望保持业务逻辑的纯净性

1. 1. ✅ 精确捕获异常，避免裸 except
2. 2. ✅ 善用 else 子句让逻辑清晰
3. 3. ✅ 使用 finally 确保资源清理
4. 4. ✅ 优先使用 with 语句管理资源
5. 5. ✅ 设计有意义的自定义异常
6. 6. ✅ 使用异常链保留原始上下文
7. 7. ✅ 合理记录异常日志
8. 8. ✅ 将异常处理与业务逻辑分离

• • 类和对象的基本概念
• • 封装、继承、多态三大特性
• • 魔术方法（Magic Methods）的妙用
• • 如何设计优雅的类层次结构