如何使用Python Sentry SDK为报错添加额外信息且不产生重复报错

核心思路是通过Sentry SDK的作用域（Scope）机制为后续自动上报的异常绑定额外上下文，无需主动上报异常，既不会产生重复记录，也不会破坏原有错误分组规则。

具体实现步骤 #

1. 导入sentry_sdk依赖
2. 在抛出异常前通过sentry_sdk.push_scope()创建临时作用域，将额外数据存入作用域的extra或自定义上下文字段中
3. 正常抛出异常即可，Sentry自动捕获该异常时会自动带上作用域内的所有额外数据

修改后的示例代码如下：

import requests
import json
import sentry_sdk

resp = requests.post(url, json=payload)
if resp.ok:
    return resp.json()
try:
    text = resp.json()
except json.JSONDecodeError:
    text = resp.text

# 👇 替换原有TODO的代码，绑定额外数据到临时作用域
with sentry_sdk.push_scope() as scope:
    # 将响应内容存入extra字段，可根据需要自定义key名称
    scope.set_extra("failed_http_response", text)
    # 也可以添加自定义标签，方便后续在Sentry中筛选
    scope.set_tag("http_status_code", resp.status_code)
    # 抛出异常，Sentry自动上报时会携带上面设置的所有上下文数据
    resp.raise_for_status()

方案合理性说明 #

• 仅生成1条报错记录：没有主动调用capture_exception、capture_message等主动上报接口，只有resp.raise_for_status()抛出异常时Sentry自动上报的唯一一条记录
• 不破坏错误分组：额外数据存储在Sentry事件的extra独立字段中，没有修改异常本身的类型、消息等用于分组的核心字段，不会影响原有分组规则
• 上下文隔离：push_scope()创建的是临时作用域，出了当前with代码块后设置的额外数据自动失效，不会污染其他场景的错误上报

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