如何正确重新抛出自定义异常？捕获异常转为SyncthingError的标准写法？

嘿，这两个问题都是Python异常处理里的高频场景，我给你拆解一下标准做法，顺便说说容易踩的坑：

核心原则是保留原始异常的上下文，这样调试时能完整追踪错误根源，规范写法分两种情况：

• 如果是捕获某个异常后，要替换成自定义异常抛出：
  必须用raise 自定义异常("描述信息") from 原始异常的语法，它会把原始异常设为新异常的__cause__，栈追踪里会同时显示两个异常的信息，帮你快速定位问题。
• 如果只是想原样重新抛出当前捕获的异常：
  直接写raise不带任何参数即可，它会完整保留原始异常的栈信息和上下文，绝对不要自己重新实例化异常再抛，那样会丢失关键的调试数据。

举个实际例子：

class DataProcessingError(Exception):
    """自定义数据处理异常"""
    pass

try:
    # 模拟可能出错的操作
    int("not_a_number")
except ValueError as original_err:
    # 带上下文抛出自定义异常
    raise DataProcessingError("无法将字符串转换为数字") from original_err

# 要是只想重新抛出原异常，就这么写：
try:
    risky_operation()
except ValueError:
    raise  # 原样抛出，保留所有上下文

你之前的写法失效，大概率是没保留原始异常上下文，或者捕获范围太宽泛/太窄。标准写法要满足这几点：

1. 只捕获你预期的异常类型：别裸捕Exception，否则会不小心捕获到KeyboardInterrupt这类系统级异常，破坏程序的正常退出逻辑。
2. 用from关联原始异常：让SyncthingError携带原始异常的上下文，方便排查库内部到底是哪一步出了问题。
3. 给异常添加清晰的描述信息：把原始异常的信息包含进去，让调用者能快速理解错误原因。

正确的示例代码：

class SyncthingError(Exception):
    """Syncthing库的通用异常类"""
    pass

def sync_files():
    try:
        # 模拟库内可能触发异常的操作，比如API调用
        with open("non_existent_file.txt", "r") as f:
            content = f.read()
    except FileNotFoundError as original_err:
        # 转换为库通用异常，并绑定原始异常上下文
        raise SyncthingError(f"同步文件失败: 找不到文件 - {str(original_err)}") from original_err

如果你之前的写法是像下面这样，就会导致上下文丢失，调试困难：

# 错误写法：没有关联原始异常
try:
    # ...
except FileNotFoundError as e:
    raise SyncthingError("同步失败")  # 看不到原始的FileNotFoundError信息

如果你的SyncthingError需要额外的参数（比如错误码），也可以这样写：

class SyncthingError(Exception):
    def __init__(self, message, error_code):
        super().__init__(message)
        self.error_code = error_code

try:
    # ...
except ConnectionError as e:
    raise SyncthingError(f"连接Syncthing节点失败: {str(e)}", error_code=1001) from e

内容的提问来源于stack exchange，提问作者blakev