Python Flask自定义异常上报Sentry丢失stacktrace堆栈问题如何解决

错误原因 #

你直接实例化自定义异常上报时，新生成的SentryMailError对象没有关联原始异常的堆栈上下文，仅包含你实例化该自定义异常这一步的调用信息，因此Sentry无法获取到原始出错位置的完整堆栈。另外你示例代码里存在笔误：SentryMaiLError拼写和定义的类名不一致，也可能导致异常识别异常。

修复方案 #

方案1：使用Python异常链绑定上下文（最推荐） #

利用Python原生的raise ... from ...异常链机制，自动将原始异常的堆栈关联到自定义异常上，无需额外手动处理：

from sentry_sdk import capture_exception

class SentryMailError(Exception):
    """Errors related to sending emails"""
    def __init__(self, err):
        super().__init__(err)

def randomfunc():
    try:
        division_by_zero = 1 / 0
    except Exception as err:
        try:
            # 绑定原始异常作为自定义异常的cause
            raise SentryMailError(err) from err
        except SentryMailError as custom_err:
            capture_exception(custom_err)

上报后Sentry会识别SentryMailError类型，同时保留完整的原始堆栈，可直接按自定义异常类型配置告警规则。

方案2：手动绑定traceback属性 #

如果不想嵌套额外的try-except，可以手动给自定义异常绑定原始异常的traceback属性：

def randomfunc():
    try:
        division_by_zero = 1 / 0
    except Exception as err:
        custom_err = SentryMailError(err)
        # 手动关联原始堆栈
        custom_err.__traceback__ = err.__traceback__
        capture_exception(custom_err)

方案3：给原始异常打标记分类 #

如果不需要严格区分异常类，也可以直接上报原始异常，通过Sentry的scope打标签/指纹做分类，同样可以实现自定义告警：

from sentry_sdk import capture_exception, push_scope

def randomfunc():
    try:
        division_by_zero = 1 / 0
    except Exception as err:
        with push_scope() as scope:
            scope.set_tag("error_type", "SentryMailError")
            scope.fingerprint = ["SentryMailError", "{{ default }}"]
            # 上报原始异常保留完整堆栈
            capture_exception(err)

后续在Sentry后台直接按error_type标签筛选配置告警即可。

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