gin.default()会丢消息，因其默认logger同步阻塞写stdout，高并发时拖慢响应且无重试缓冲；报警通道未封装独立函数、未设超时与错误处理，导致smtp/webhook失败仍返回200。
为什么直接用 gin.Default() 做报警网关会丢消息？
因为默认 Logger 是同步写 stdout，高并发报警请求一涌而上时，gin.Default() 的日志中间件会阻塞 goroutine，且没有失败重试或缓冲机制。更致命的是，它不处理邮件发送失败、短信网关超时、Webhook 超时等真实错误场景，只返回 200 就完事——你以为发出去了，其实卡在 SMTP 连接里。
- 必须替换默认 Logger：用
zap.Logger+ 异步 channel 写入，避免主流程阻塞 - 所有报警通道（邮件/短信/Webhook）必须封装为独立函数，返回
error，并在 handler 中显式判断 - 不要把
smtp.SendMail直接塞进 HTTP handler；要加 context.WithTimeout，超时后主动 cancel 并记录失败原因 - 示例中常见错误：
c.JSON(200, gin.H{"ok": true})紧跟在 SendToMail 后面——哪怕邮件发一半断连，也返回成功
SendToMail 函数里哪些字段必须校验？
不是所有字段都该由前端传，也不是所有字段都能信任。比如 Source 字段若来自用户输入，直接拼进 From 头会导致 SMTP 注入；Contacts 若含多个邮箱却没做分隔解析，smtp.SendMail 会静默失败。
-
Source必须白名单限制（如只允许"alert@company.com"或预设几个内部邮箱），不能直接透传 -
Contacts要用strings.Split(to, ";")拆分，并对每个邮箱做mail.ParseAddress校验格式 -
Subject和Content需做长度截断（Subject ≤ 78 字符，Content ≤ 10KB），防止 SMTP 服务端拒绝 - 别硬编码
host（如"smtp.qq.com:587"）；应从配置文件或环境变量读取，且支持 TLS/STARTTLS 自动协商
如何让同一个接口支持邮件、钉钉、企业微信三路报警？
靠 if-else 堆逻辑只会让 handler 越来越胖，且新增渠道就得改主流程。正确做法是抽象出 AlertSender 接口，每种渠道实现自己的 Send() 方法，再用 map 动态路由。
- 定义接口：
type AlertSender interface { Send(ctx context.Context, alert *Alert) error } - 注册时用
senders["email"] = &EmailSender{...}、senders["dingtalk"] = &DingTalkSender{...} - handler 中根据
c.Param("channel")或c.Query("channel")查 map，找不到就 400 - 注意：钉钉和企微 Webhook 必须带签名 timestamp + sign 计算，不能漏掉
time.Now().Unix()和 HMAC-SHA256 步骤 - 企业微信的
msgtype必须匹配 body 结构（text/card/markdown），否则返回 40072 错误
报警网关最常被忽略的超时与重试控制点
报警不是普通 API，它要求“尽力送达”，但又不能无限重试拖垮网关。多数人只设了 HTTP client timeout，却忘了底层 TCP 连接、DNS 解析、TLS 握手这些环节各自有独立超时。
- SMTP 客户端必须设
net/smtp.Client的Timeout（建议 10s）、TLSConfig的HandshakeTimeout（5s） - HTTP 类渠道（钉钉/企微）的
http.Client.Timeout设为 5s 即可，但要额外配Transport.IdleConnTimeout = 30s，防连接池僵死 - 重试仅限网络层错误（
net.OpError、context.DeadlineExceeded），非 5xx 不重试——钉钉返回{"errcode":40014,"errmsg":"invalid access_token"}是鉴权问题，重试无意义 - 每种渠道重试次数上限设为 1，且加 jitter（如 100ms ± 50ms），避免瞬间打爆第三方限流
go tool pprof 抓一次压测 profile，重点看 runtime.mallocgc 和 net/http.(*Client).do 占比——如果后者超过 30%，说明 transport 层没调优到位。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
