2. 异常捕获基础：Python异常处理机制

在嵌入式设备端配置与上位机联合调试的场景中，异常捕获是保障系统稳定性的第一道防线。设备通信超时、配置参数格式错误、硬件接口无响应等状况，都需要通过结构化的异常处理机制来优雅应对。本章将系统讲解Python的异常处理核心语法、异常类型层次结构以及自定义异常类的实战方法。

2.1 try/except/else/finally 完整语法

Python的异常处理采用四段式结构，每一段都有明确的职责分工。下表总结了各子句的执行时机与典型用途：

以下代码展示了在设备配置读取场景中，四段结构的完整用法：

def load_device_config(config_path):
    """
    从文件加载设备配置，处理文件不存在、格式错误等异常。
    """
    config = None
    try:
        # 可能引发 FileNotFoundError 或 PermissionError
        with open(config_path, 'r') as f:
            raw_data = f.read()
        # 可能引发 json.JSONDecodeError
        config = json.loads(raw_data)
    except FileNotFoundError:
        print(f"[ERROR] 配置文件未找到: {config_path}")
        # 使用默认配置回退
        config = get_default_config()
    except json.JSONDecodeError as e:
        print(f"[ERROR] 配置文件格式错误: {e}")
        # 记录错误后重新抛出，由上层决定处理策略
        raise
    else:
        print(f"[INFO] 配置加载成功，共 {len(config)} 个参数")
        # 在无异常时执行配置校验
        validate_config_schema(config)
    finally:
        # 无论成功或失败，都记录操作日志
        log_operation(f"load_config({config_path})")
        print("[INFO] 配置加载流程结束，资源已清理")
    return config

2.2 异常类型层次结构

Python的异常体系采用严格的类继承结构，所有异常都继承自 BaseException。理解这一层次结构，有助于在 except 子句中精确捕获目标异常，避免过度捕获或遗漏。

2.3 自定义异常类

在设备端配置联合调试中，内置异常往往无法准确表达业务语义。通过继承 Exception 创建自定义异常类，可以携带设备ID、错误码、原始数据等上下文信息，大幅提升调试效率。

2.3.1 自定义异常的基本结构

class DeviceConfigError(Exception):
    """
    设备配置相关异常的基类。
    所有与设备配置相关的自定义异常都应继承此类。
    """
    def __init__(self, message, device_id=None, error_code=None):
        self.message = message
        self.device_id = device_id
        self.error_code = error_code
        super().__init__(self.message)

    def __str__(self):
        parts = [f"DeviceConfigError: {self.message}"]
        if self.device_id:
            parts.append(f"[device_id={self.device_id}]")
        if self.error_code:
            parts.append(f"[error_code={self.error_code}]")
        return " ".join(parts)

class ConfigFormatError(DeviceConfigError):
    """配置文件格式不符合规范时抛出"""
    pass

class ConfigTimeoutError(DeviceConfigError):
    """设备配置写入超时时抛出"""
    pass

class ConfigValidationError(DeviceConfigError):
    """配置参数校验失败时抛出"""
    def __init__(self, message, device_id=None, error_code=None, invalid_params=None):
        super().__init__(message, device_id, error_code)
        self.invalid_params = invalid_params or []

    def __str__(self):
        base = super().__str__()
        if self.invalid_params:
            params_str = ", ".join(self.invalid_params)
            base += f" [invalid_params={params_str}]"
        return base

2.3.2 自定义异常在联合调试中的应用

以下代码展示了如何在设备配置写入流程中使用自定义异常，实现精确的错误定位：

def write_device_config(device_id, config_dict, timeout=5.0):
    """
    向指定设备写入配置参数。
    可能抛出 ConfigFormatError、ConfigTimeoutError、ConfigValidationError。
    """
    if not isinstance(config_dict, dict):
        raise ConfigFormatError(
            "配置参数必须是字典类型",
            device_id=device_id,
            error_code="E1001"
        )

    # 模拟设备通信
    try:
        response = send_to_device(device_id, config_dict, timeout)
    except socket.timeout:
        raise ConfigTimeoutError(
            f"设备 {device_id} 配置写入超时（{timeout}s）",
            device_id=device_id,
            error_code="E2003"
        )

    # 校验设备返回的确认信息
    if response.get("status") != "ok":
        failed_params = response.get("failed_fields", [])
        raise ConfigValidationError(
            f"设备 {device_id} 配置校验失败",
            device_id=device_id,
            error_code="E3007",
            invalid_params=failed_params
        )

    return True

2.4 异常处理最佳实践（设备端场景）

结合嵌入式设备端配置的典型场景，以下列表总结了异常处理的关键实践：

• 精确捕获：优先捕获具体异常子类，避免使用裸 except: 或 except Exception: 吞噬所有异常。
• 保留上下文：使用 raise ... from original_exception 保留异常链，便于追溯根因。
• 日志先行：在 except 块中先记录结构化日志，再决定是否重新抛出或恢复。
• 资源清理：将设备句柄、文件描述符的释放放在 finally 或使用 with 上下文管理器。
• 超时处理：设备通信必须设置超时，并捕获 TimeoutError 或 socket.timeout。

2.5 本章小结