不能直接用net/smtp封装通用发送函数，因不同邮件后端（如SendGrid、Postfix）认证方式、API路径、请求格式、错误结构互不兼容；net/smtp仅支持SMTP协议，对HTTP类API无效；强行统一会导致参数爆炸、类型难收敛、调用方需预知后端类型。
为什么不能直接用 net/smtp 封装一个通用发送函数
因为不同邮件后端（如腾讯企业邮箱、sendgrid、mailgun、自建 postfix）的认证方式、api 路径、请求体格式、错误返回结构完全不一致。net/smtp 只能处理 smtp 协议层，对 sendgrid 这类 http api 后端完全无效；而硬塞所有后端进一个 send() 函数会导致参数爆炸（比如要不要传 api_key、region、smtp_host？）、类型难收敛、调用方必须预知后端类型。
真正可行的做法是定义统一的邮件模型 + 各后端独立实现发送逻辑，靠接口隔离差异：
type Email struct {
From string
To []string
Subject string
Body string
HTML bool // 是否为 HTML 邮件
}
<p>type Mailer interface {
Send(*Email) error
}如何设计可插拔的后端注册与分发机制
避免在业务代码里写 if backend == "sendgrid" { ... } —— 这种分支会随新后端不断膨胀。推荐用 map 注册 + 工厂函数：
- 每个后端实现
Mailer接口，例如SendGridMailer、SMTPMailer - 提供初始化函数，如
NewSendGridMailer(apiKey string)或NewSMTPMailer(host, user, pass string) - 全局注册表用
map[string]func() Mailer，键为后端名（如"sendgrid"、"smtp"），值为构造函数 - 发送时通过配置项（如 YAML 中的
backend: sendgrid）查表获取实例，复用一次即可
注意：不要在注册表里存已初始化的实例（除非明确是单例且无状态），否则无法按环境隔离配置（如测试环境用 mock，生产用真实 SendGrid）。
SMTP 后端最容易踩的坑：认证失败但错误信息模糊
net/smtp 的 Auth 类型只支持 PLAIN 和 CRAM-MD5，但很多服务商（如腾讯企业邮箱）要求 LOGIN 认证，而标准库不内置。此时必须手动实现 smtp.Auth 接口：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
type loginAuth struct {
username, password string
}
<p>func (a <em>loginAuth) Start(server </em>smtp.ServerInfo) (string, []byte, error) {
return "LOGIN", []byte{}, nil
}</p><p>func (a *loginAuth) Next(fromServer []byte, more bool) ([]byte, error) {
if more {
switch strings.TrimSpace(strings.ToLower(string(fromServer))) {
case "username:":
return []byte(a.username), nil
case "password:":
return []byte(a.password), nil
}
}
return nil, nil
}- 调用
smtp.SendMail时传入&loginAuth{...}，而非smtp.PlainAuth - 常见错误现象：
535 Authentication failed却没打日志，实际是 AUTH 命令被拒绝，需抓包或启用smtp.DebugWriter确认协商过程 - 端口别硬写 25：腾讯用 465（SSL）或 587（STARTTLS），Gmail 强制 587 + STARTTLS，漏掉
smtp.StartTLS步骤会连接成功但认证失败
HTTP 类后端（如 SendGrid）必须处理的三个细节
SendGrid / Mailgun 等走 REST API，和 SMTP 完全不是一回事，关键点不在“怎么发”，而在“怎么稳”：
- 请求头必须带
Authorization: Bearer <api_key>，且Content-Type固定为application/json；少一个头，返回401或406但错误信息可能只写 “unauthorized” - SendGrid 的收件人字段叫
personalizations.0.to，不是扁平的to；嵌套 JSON 结构写错一级（比如漏掉personalizations数组）会导致静默失败（返回 202 但邮件永不送达） - 务必设置超时：
http.Client{Timeout: 15 * time.Second}；否则网络卡住时 goroutine 泄露，尤其在高并发发信场景下会拖垮整个服务
复杂点在于：不同后端对附件、抄送、模板变量的支持程度天差地别，统一抽象容易削足适履。建议基础 Email 结构只保核心字段，扩展能力（如附件）通过后端专属方法暴露（如 SendGridMailer.SendWithAttachment()），不强求接口完全一致。
