根本原因是Django在DEBUG=False时不触发logging.ERROR传播，而Sentry默认只监听该级别；必须在settings.py中显式配置LOGGING，将django.request和django.security的ERROR日志传给Sentry handler，并确保environment='production'、release动态对齐CI/CD。
为什么直接配 SENTRY_SDK 会收不到线上错误？
多数人装完 sentry-sdk、填了 DSN 就以为完事了，结果线上 500 一点没上报。根本原因是：Django 的异常捕获链路里，DEBUG=False 时默认不触发 logging 的 ERROR 级别传播，而 Sentry 默认只监听 logging.ERROR 及以上 —— 中间断了一环。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 必须在
settings.py中显式配置LOGGING，把django.request和django.security的ERROR日志传给 Sentry 的handler - 确保
DEBUG=False且ALLOWED_HOSTS已正确设置，否则 Django 会直接返回空白响应，连异常都进不了中间件 - 不要依赖
init()的自动集成（比如integrations.DjangoIntegration()单独启用），它只覆盖视图层，漏掉中间件、管理命令、异步任务等场景
capture_exception() 和手动 try/except 怎么用才不重复上报？
线上看到同一条错误在 Sentry 里炸出几十个事件？大概率是既被 Django 的 request_finished 信号捕获了一次，又被你手写的 capture_exception() 再报一次。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 只在「已吞掉异常但还想留痕」的场景用
capture_exception()，比如自定义中间件里process_exception捕获后返回了友好页面，这时调用一次即可 - 避免在视图函数里写
try/except+capture_exception()，Django 默认就会把未处理异常交给 Sentry（前提是上面 LOGGING 配好了） - 若需附加上下文，优先用
sentry_sdk.set_context()或sentry_sdk.set_tag()，而不是靠多报一次异常来带数据
异步任务（Celery）报错不上报？检查这三个地方
Celery worker 进程完全独立于 Django WSGI 进程，sentry-sdk.init() 必须在 worker 启动时执行，不是在 Django settings 里配了就自动生效。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在
celery.py初始化 Celery 实例后立刻调用sentry_sdk.init()，不要复用 Django 的配置入口 - 确认 Celery 的
task_track_started=True，否则失败任务可能连状态都不更新，Sentry 拿不到 traceback - 如果用了
@shared_task(bind=True)，可在self.retry()前加sentry_sdk.capture_exception()，但注意重试次数上限，避免刷爆事件数
报警收不到？别只盯着 Webhook，先看 sample_rate 和 traces_sample_rate
很多人配完 Slack / 邮件通知，发现只有高频错误有提醒，低频的全没了 —— 默认 sample_rate=1.0 是假象，实际受 traces_sample_rate 和环境变量 SENTRY_ENVIRONMENT 共同压制。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 生产环境务必显式设
environment='production'，否则 Sentry 会当成dev处理，限流更激进 - 调试期可临时设
sample_rate=1.0和traces_sample_rate=1.0，上线后再调回0.1或更低 - Webhook 报警依赖 Sentry 服务端的规则匹配，重点检查「Alert Rules」里是否勾选了对应 Environment 和 Issue Level（比如只设了
error，但你的异常是critical就不会触发）
最常被忽略的是：Sentry 的 release 版本号没和 CI/CD 对齐，导致错误堆栈无法 source map，或者报警规则按 release 分组时直接失效。每次部署必须带 release=os.environ.get('GIT_COMMIT') 这类动态值，硬编码字符串等于没设。
