Python代码中添加异常上下文的最佳实践：重抛异常补充信息

你的代码存在两个核心问题：

1. 直接修改异常的e.args属性属于非常规操作，不同异常类对args的依赖逻辑不同，容易引发意外bug；
2. 通过拆分e.args提取上下文的方式不够健壮，一旦异常的参数结构变化，处理逻辑就会出错。

结合你「修改异常消息字符串而非添加单独元数据」的需求，推荐两种最佳实践：

方式1：重抛时拼接消息，保留原始异常上下文 #

重新构造同类型异常实例，把上下文信息拼接到原始消息中，同时用raise ... from e显式关联原始异常，既更新消息内容，又保留完整的异常追踪栈。

示例代码：

def internal_function():
    raise ValueError("smelly socks!")

def context_function():
    try:
        internal_function()
    except ValueError as e:
        # 拼接上下文到原始消息
        new_message = f"{str(e)} [上下文：执行用户订单处理]"
        # 重抛新的异常，关联原始异常
        raise ValueError(new_message) from e

def handler_function():
    try:
        context_function()
    except ValueError as e:
        error_msg = str(e)
        if "[上下文：执行用户订单处理]" in error_msg:
            # 针对该上下文的处理逻辑
            print("处理订单流程中的异常")
        else:
            # 其他处理逻辑
            print("处理通用异常")

这种方式的优势：

• 不修改原始异常的内部属性，符合Python异常设计规范；
• 保留了异常链式追踪，调试时能同时看到原始错误触发点和上下文补充的位置；
• 消息是统一字符串，处理逻辑直观易懂。

方式2：自定义异常类（更健壮的场景） #

如果需要频繁在异常中携带上下文，自定义异常类是更清晰的选择。你可以在类中封装上下文信息，同时重写__str__方法自动拼接消息和上下文，既满足修改消息的需求，又能实现结构化的信息存储。

示例代码：

class ContextualError(ValueError):
    def __init__(self, original_msg, context):
        super().__init__(original_msg)
        self.context = context

    def __str__(self):
        # 自动拼接原始消息和上下文
        return f"{super().__str__()} [上下文：{self.context}]"

def internal_function():
    raise ValueError("smelly socks!")

def context_function():
    try:
        internal_function()
    except ValueError as e:
        # 抛出自定义异常，传入原始消息和上下文
        raise ContextualError(str(e), "执行用户订单处理") from e

def handler_function():
    try:
        context_function()
    except ContextualError as e:
        # 直接通过属性访问上下文，无需解析字符串
        if e.context == "执行用户订单处理":
            print("处理订单流程中的异常")
        else:
            print("处理其他异常")

这种方式的优势：

• 上下文是结构化属性，比解析字符串更可靠，避免消息格式变化导致的处理错误；
• 自定义异常类可根据业务需求扩展更多属性，扩展性更强；
• 同样保留了原始异常的追踪信息，便于调试。

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