如何使用Python Django集成钉钉机器人实现异常报警？-Python教程-PHP中文网

直接用django logging模块+钉钉webhook即可实现异常报警，无需额外框架；需配置加签或ip白名单安全策略，继承logging.handler编写异步钉钉发送逻辑，捕获exc_info并格式化堆栈，通过settings.py注册handler并设置verbose formatter确保含模块名、行号、完整traceback等关键定位信息。

如何使用python django集成钉钉机器人实现异常报警？

直接用 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 并格式化堆栈，避免只发空消息。

Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载

不要在 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。

必须设置 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 属性拼出来，少一个字段，排查时间就翻倍。