应选用 mailgun-go 并手动配置 v3 API：调用 SetAPIBase("https://api.mailgun.net/v3")、SetDomain() 用已验证域名、使用 Private API Key；封装线程安全异步发送器，支持重试与日志；邮件需双版本内容、合规 From 和 Message-ID；上线前验证 DNS 与邮箱有效性。
Mailgun API v3 的 Go 客户端怎么选才不踩坑
官方没提供 Go SDK，社区最常用的是 mailgun-go，但注意：它默认用的是 Mailgun v2 API（已弃用），v3 需要手动指定域名和认证方式。直接 go get github.com/mailgun/mailgun-go 拉下来的版本若未显式设置 SetAPIBase，发信会返回 401 Unauthorized 或 404 Not Found —— 因为请求仍打向旧 endpoint。
- 必须调用
mg.SetAPIBase("https://api.mailgun.net/v3")，否则默认走https://api.mailgun.com/v2 - Domain 必须是已验证的发送域（如
mg.SetDomain("mg.example.com")），不能填邮箱后缀或任意字符串 - API Key 要用私钥（Private API Key），不是公钥（Public API Key），位置在 Mailgun 控制台的
Settings → API Keys - 测试时先用 sandbox 域 + 已验证的收件邮箱，避免被限流或拒信
如何封装一个线程安全、可重试的异步邮件发送器
告警邮件不能阻塞主流程，且网络波动常见，得用 goroutine + 重试 + 错误日志闭环。别直接裸调 mg.Send，它底层是 HTTP 请求，失败时不自动重试，也不带 context 超时控制。
- 用
sync.Pool复用*mailgun.Mailgun实例（避免重复初始化开销） - 发送逻辑包进
func (s *Mailer) SendAsync(...)，内部起 goroutine，失败时最多重试 2 次（间隔 1s），超时设为 5s - 重试条件只针对临时错误：
net.Error、http.StatusTooManyRequests、http.StatusInternalServerError；400/401/404 类错误立即放弃 - 每次发送结果写入结构化日志（含 message-id、status code、error），方便排查“告警没收到”类问题
告警邮件模板怎么写才不被当成垃圾邮件
Mailgun 对发信内容有反垃圾策略：纯文本太简陋，HTML 太花哨易触发过滤，Subject 过长或含敏感词（如“ALERT”“CRITICAL”）会被降权。关键不是“能发出去”，而是“能进收件箱”。
- Subject 控制在 50 字符内，用前缀标识服务名，例如
[orders-api] CPU > 90%，避免全大写或感叹号 - Body 必须同时提供
Text和HTML版本，Text是纯 ASCII，换行用\n，不含链接；HTML用内联 style，禁用 JS 和远程图片 - From 地址必须是验证域下的邮箱（如
alert@mg.example.com），不能用 Gmail 或 QQ 邮箱中转 - 每封邮件加唯一
Message-ID（可用uuid.New().String()），避免被识别为重复投递
如何验证告警通道是否真正可用
本地跑通不代表线上可靠。Mailgun 的 rate limit、IP reputation、DNS 配置都会影响实际送达率，尤其在首次上线或扩容后。
立即学习“go语言免费学习笔记（深入）”；
- 上线前做三件事：用
dig TXT mg.example.com确认 SPF 记录存在；dig MX mg.example.com看 MX 是否指向 mailgun.org；用 Mailgun 的validateAPI 检查收件邮箱格式有效性 - 上线后第一周，每天抽样检查 3 封告警邮件的
message-id，在 Mailgun 控制台的Logs → Messages里查状态（accepted≠delivered） - 监控
mailgun-go返回的Response.Message字段，如果含"Queued. Thank you."说明入队成功，但后续失败不会回调通知，得靠日志+控制台交叉验证
最常被忽略的是 DNS 传播延迟和 sandbox 域的收件邮箱白名单机制——改完 DNS 后等不到 24 小时就发生产告警，大概率石沉大海。
