Python：如何在通用API异常处理器中捕获前置原始异常？

这里有两种靠谱的方法可以实现你的需求，核心是把原始的KeyError和自定义的APIException关联起来，让全局处理器能拿到底层的异常信息：

方法1：使用Python原生的异常链（推荐） #

Python支持用raise ... from语法建立异常链，这样新抛出的APIException会保留原始异常的引用，存储在__cause__属性中。

步骤1：修改抛出APIException的代码 #

try:
    do_stuff()
except KeyError as exc:
    # 用from语法关联原始KeyError
    raise APIException("No good") from exc

步骤2：在全局异常处理器中提取原始异常 #

def exception_handler(exc, context):
    # 获取原始异常：如果有__cause__则用它，否则用当前异常
    original_exc = exc.__cause__ if exc.__cause__ is not None else exc
    
    # 用logger.exception自动记录完整栈跟踪（比log更实用）
    logger.exception(f"原始异常类型: {type(original_exc).__name__}", exc_info=original_exc)
    
    return Response({"message": "try again sam"}, status_code=400)

这种方式完全符合Python的异常处理规范，不需要修改自定义异常类的结构，还能保留完整的异常栈信息。

方法2：给自定义APIException添加原始异常属性 #

如果不想用原生的异常链，也可以在自定义APIException时专门加一个属性来存储原始异常。

步骤1：修改APIException类 #

class APIException(Exception):
    def __init__(self, message, original_exception=None):
        super().__init__(message)
        # 存储原始异常
        self.original_exception = original_exception

步骤2：抛出时传入原始异常 #

try:
    do_stuff()
except KeyError as exc:
    raise APIException("No good", original_exception=exc)

步骤3：在处理器中提取原始异常 #

def exception_handler(exc, context):
    # 优先取自定义属性里的原始异常，没有则用当前异常
    original_exc = exc.original_exception if hasattr(exc, 'original_exception') else exc
    
    logger.exception("捕获到原始异常", exc_info=original_exc)
    
    return Response({"message": "try again sam"}, status_code=400)

补充说明 #

• 推荐使用logger.exception而不是logger.log，因为它会自动记录异常的完整栈跟踪，方便后续排查问题。
• 两种方法都能让你在全局处理器中拿到原始的KeyError，避免在业务代码中重复写日志逻辑，实现代码解耦。

内容的提问来源于stack exchange，提问作者A. Basf