Python异常自动推送钉钉/企微需封装异常处理器,精简traceback、添加timestamp/sign签名、处理网络超时与频率限制,并按环境、异常类型、频率过滤告警。

Python报错后怎么自动发消息到钉钉
直接用 requests.post 调钉钉 Webhook 地址就行,但得包装成异常处理器,不能每次手动写。关键是把 traceback 信息精简后塞进 JSON body,否则钉钉会拒收或显示不全。
- 钉钉 Webhook 必须带
timestamp和sign(开启签名验证时),漏掉就 403;没开签名就只用access_token - 消息体最大 2048 字符,
traceback.format_exc()常超长,建议截取最后 10 行或用traceback.format_exception()控制粒度 - 别在
except里直接调requests.post——网络失败会导致异常被吞,加一层try/except requests.RequestException - 示例片段:
import requests, traceback, time, hmac, base64, urllib.parse<br><br>def send_dingtalk_alert(webhook_url, msg):<br> timestamp = str(int(time.time() * 1000))<br> secret = "YOUR_SECRET"<br> secret_enc = secret.encode('utf-8')<br> string_to_sign = f'{timestamp}\n{secret}'<br> string_to_sign_enc = string_to_sign.encode('utf-8')<br> hmac_code = hmac.new(secret_enc, string_to_sign_enc, digestmod=hashlib.sha256).digest()<br> sign = urllib.parse.quote_plus(base64.b64encode(hmac_code))<br> url = f"{webhook_url}×tamp={timestamp}&sign={sign}"<br> payload = {"msgtype": "text", "text": {"content": msg}}<br> try:<br> requests.post(url, json=payload, timeout=5)<br> except requests.RequestException:<br> pass # 网络失败不阻断主逻辑
企业微信机器人报错推送为什么总失败
90% 是因为 JSON 格式不对或 token 错了。企业微信对字段名大小写、嵌套层级、字符串转义更敏感,比如 markdown 消息必须用 markdown 字段,不是 text。
- Webhook URL 末尾不能带斜杠,
https://qyapi.weixin.qq.com/.../xxx/会 404,要改成https://qyapi.weixin.qq.com/.../xxx - 发送
text类型时,content字段值不能含未转义的换行符,用\n可以,但原始\r\n或多空行容易触发校验失败 - 企业微信不支持直接发完整 traceback,建议提取
sys.exc_info()中的错误类型和一行摘要,再附上关键变量快照(如repr(locals().get("user_id"))) - 测试时先用 curl 手动发一次:
curl -X POST "WEBHOOK_URL" \<br>-H "Content-Type: application/json" \<br>-d '{"msgtype": "text", "text": {"content": "test"}}'
怎么让报警只发严重异常,不刷屏
不是所有 Exception 都该告警。得按异常类型、发生频率、上下文过滤,否则日志没报错,钉钉先崩了。
- 跳过
KeyboardInterrupt、SystemExit、ConnectionError(重试场景下)这类预期中的中断 - 用
functools.lru_cache或内存字典缓存最近 5 分钟内相同type(e).__name__ + str(e)[:50]的报错,重复就不发 - 在 Flask/FastAPI 的全局异常处理器里加判断:只有
request.path.startswith("/api/")且状态码是 500 才触发;后台任务则检查是否在celery.task上下文中 - 别依赖
logging.exception自动捕获——它不区分环境,本地开发也发,加个if os.getenv("ENV") == "prod"
Webhook 超时或丢消息怎么办
同步调用 Webhook 是最简单的方式,但也是最不可靠的。网络抖动、机器人接口限流、DNS 解析失败都会导致消息消失,且无回调确认。
- 不要在主线程阻塞等响应,设
timeout=(3, 3)(连接 3 秒 + 读取 3 秒),超时就放弃 - 真正要保底,得异步落库+定时重推:把待发消息写进 SQLite 或 Redis,另起一个线程每 30 秒扫一次未成功记录
- 钉钉/企微都有调用频率限制(比如钉钉 20 次/分钟),别在 for 循环里挨个发异常,聚合为一条消息,用
text类型的content拼多行错误摘要 - 最关键的是:Webhook 地址本身要存配置中心或环境变量,别硬编码——改地址不用发版,运维才不会半夜骂你
实际跑起来你会发现,最难的不是发消息,而是判断“这错该不该惊动别人”。比如数据库连不上,是刚发布导致的短暂抖动,还是主库真挂了?这种边界,代码没法全自动判,得靠日志上下文 + 业务语义。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











