钉钉机器人Webhook需签名验证，必须用当前时间戳拼接密钥生成HMAC-SHA256 Base64签名并作为URL参数；封装DingTalkAlert需线程安全、重试、限流；消息选text或markdown需注意长度与格式限制；防报警风暴须聚合、限频、分级；关键信息须前置并关联监控标签。
钉钉机器人 Webhook 签名验证失败怎么办
直接用 http.Post 发 JSON 就会 403，因为钉钉要求带签名的 Webhook 地址（含 timestamp 和 sign）。不验签或时间戳偏差超 1 小时，请求直接被拒。
- 必须用当前 Unix 时间戳（秒级）拼接密钥，再做 HMAC-SHA256，最后 Base64 编码生成
sign - 时间戳和签名要作为 URL 查询参数传入，不是放在 body 或 header 里
- 注意系统时钟是否准确——Docker 容器里常因未同步导致签名失效，建议加
ntpdate -s time.windows.com或用chrony - 示例拼接逻辑：
sign = base64(hmacsha256(timestamp + "\n" + secret, secret))
如何封装一个线程安全、可重试的 DingTalkAlert 结构体
报警不能丢，也不能阻塞主流程。裸调 HTTP 容易 panic 或超时卡死，得包装成带重试、限流、错误回调的结构体。
- 内部用
sync.RWMutex保护配置（如 webhook URL、secret），避免热更新时竞争 - HTTP client 必须设
Timeout（建议 5s）和MaxIdleConnsPerHost（防连接耗尽） - 重试策略推荐指数退避：第一次 1s 后重试，最多 3 次；失败后触发回调函数（比如写本地日志或发备用邮件）
- 不要在
Alert()方法里做 JSON 序列化——提前序列化好并缓存，避免高并发下反复分配内存
text 和 markdown 类型消息怎么选、怎么写才不被截断
钉钉对不同消息类型有隐式限制：纯文本太长会被折叠，Markdown 渲染异常则整条不显示。
-
text类型只支持单字段content，最大长度 2000 字符；超过就静默截断，无报错 -
markdown类型需同时提供title和text，其中text支持换行和简单语法（**加粗**、`code`），但不支持 HTML 或图片外链 - 关键信息（如错误码、服务名）务必放在
title或text开头 50 字内——手机端通知只显示前几行 - 避免在
text中写大段堆栈，改用link类型跳转到日志平台，或压缩后 base64 嵌入markdown的折叠代码块（需前端配合解析）
如何避免报警风暴导致钉钉限流或被禁言
钉钉对同一机器人每分钟最多接收 20 条消息，超限后返回 errcode: 90037，后续消息全丢。
立即学习“go语言免费学习笔记（深入）”；
- 必须在模块层做「聚合」：相同错误（如
mysql: connect timeout）5 分钟内只发 1 条，附带计数和首次/最近发生时间 - 加一层内存队列（如
chan *AlertEvent）+ 单独 goroutine 消费，控制发送节奏（time.Ticker控制最小间隔 ≥ 3s） - 区分等级：P0 错误直发，P1/P2 聚合后每日汇总推一次；用
level字段标记，别全堆进同一个 webhook - 上线前务必压测：模拟 100 并发告警，观察实际到达率和钉钉控制台的“调用量”曲线
真正难的不是发出去，而是让值班人一眼看懂哪台机器、哪个接口、什么时间、为什么崩——所有字段都要对齐监控系统的 tag，比如把 service=auth-api env=prod instance=10.1.2.3:8080 固定塞进 title 前缀。不然半夜爬起来，光找上下文就得三分钟。
