直接用Django logging模块+钉钉Webhook即可实现异常报警，无需额外框架；需配置加签或IP白名单安全策略，继承logging.Handler编写异步钉钉发送逻辑，捕获exc_info并格式化堆栈，通过settings.py注册handler并设置verbose formatter确保含模块名、行号、完整traceback等关键定位信息。
直接用 Django 自带的 logging 模块 + 钉钉机器人 Webhook 就能实现异常报警，不需要额外框架或中间件。
配置钉钉机器人 Webhook 地址
在钉钉群中添加自定义机器人，开启「加签」或「IP 白名单」取决于你的部署环境。生产环境强烈建议启用加签（更安全），此时需在请求头里带 timestamp 和 sign；若只用 IP 白名单，则只需确保服务器出口 IP 在白名单内，请求体直接 POST 即可。
- 加签模式下，
sign是hmac_sha256(timestamp + "\n" + secret, secret)的 base64 编码 - Webhook 地址形如
https://oapi.dingtalk.com/robot/send?access_token=xxx，别漏掉?access_token=部分 - 测试时可用
curl先验证：curl -X POST https://oapi.dingtalk.com/robot/send?access_token=xxx \ -H 'Content-Type: application/json' \ -d '{"msgtype": "text", "text": {"content": "test"}}'
编写 Django logging handler
继承 logging.Handler 实现钉钉发送逻辑，关键点是捕获 record.exc_info 并格式化堆栈，避免只发空消息。
- 不要在
emit()里做耗时操作（如同步 HTTP 请求），线上务必用异步方式（推荐threading.Thread或concurrent.futures.ThreadPoolExecutor） -
record.levelno >= logging.ERROR才触发报警，避免 info/warning 刷屏 - 注意
record.exc_text可能为None，需 fallback 到self.format(record) - 示例核心逻辑：
def emit(self, record): try: msg = self.format(record) payload = { "msgtype": "text", "text": {"content": f"[{record.levelname}] {msg}"} } # 加签逻辑略（见上节） requests.post(self.webhook_url, json=payload, timeout=5) except Exception: pass # 不要让日志 handler 崩溃影响主流程
在 settings.py 中注册 handler
把自定义 handler 注册进 LOGGING 配置，作用域选对——想捕获全局异常就配在 root，只想监控某个 app 就单独配 loggers。
立即学习“Python免费学习笔记（深入）”；
- 必须设置
formatter，否则record.exc_info不会转成字符串堆栈 - 推荐 formatter 用
verbose："format": "[%(asctime)s] %(levelname)s [%(name)s:%(lineno)s] %(message)s" - 示例配置片段：
'dingtalk': { 'level': 'ERROR', 'class': 'myapp.loghandlers.DingTalkHandler', 'webhook_url': 'https://oapi.dingtalk.com/robot/send?access_token=xxx', 'secret': 'SECxxx', # 加签用 'formatter': 'verbose' }, 'root': { 'handlers': ['console', 'dingtalk'], 'level': 'INFO' } - 本地开发时可通过
DEBUG=True关闭钉钉 handler，或用环境变量控制是否启用
验证异常是否真能触发报警
别只靠 raise Exception('test') 测试，Django 的中间件错误和未捕获异常才能进 root logger；视图里主动 logger.error(...) 也能触发，但要注意 log level。
- 最稳妥的测试方式：在视图里写
def test_view(request): raise ValueError("intentional error")，然后访问该 URL - 检查 Django 日志输出里是否有
ERROR行，并确认钉钉收到消息 - 如果没收到，先查
requests.exceptions.ConnectionError是否被吞掉（handler 里没打印异常），再确认 webhook 地址、网络连通性、加签时间戳是否超时（钉钉要求 timestamp 与当前时间差 ≤ 1 小时） - 钉钉限制每分钟最多 20 条相同内容消息，重复报错会被限流，可在 payload 里加
record.created时间戳防重
真正难的不是发消息，而是让每条报警都包含足够定位问题的信息：模块名、行号、完整 traceback、甚至 request.path —— 这些得靠 formatter 和 handler 里的 record 属性拼出来，少一个字段，排查时间就翻倍。
