Revel 框架不内置邮件模块，需手动集成 gomail 等第三方库；其设计遵循“轻量+显式”哲学，不封装 SMTP 细节，避免黑盒陷阱但要求开发者自行构建发送链路。
Revel 框架本身不内置邮件发送模块，想发邮件必须自己集成第三方库（比如 gomail 或 mailgun-go），没有 revel.Mail 这种开箱即用的门面。
为什么 Revel 没有原生 mail 包
Revel 的设计哲学是「轻量+显式」：不封装 SMTP 细节，也不预设传输方式。它把路由、控制器、模板、配置都做了抽象，但网络 I/O 层（包括 HTTP client、SMTP client）交由开发者按需选型。这意味着你不会遇到 Laravel 的 Mail::to()->send() 那类隐藏行为，也不会掉进「配置写了但没生效」的黑盒陷阱——但代价是你得亲手搭链路。
常见错误现象：
- 误以为
app.conf里加smtp.host=...就能自动启用邮件功能 - 在 controller 里直接 new
gomail.Message却忘了设置From字段，导致 Gmail/Outlook 拒收 - 用 localhost:25 发测试邮件，结果被云服务器防火墙或 ISP 屏蔽（尤其阿里云/腾讯云默认封 25 端口）
用 gomail 发送纯文本邮件（推荐入门）
gomail 是最轻量、文档最清晰的 Go SMTP 库，无依赖、API 直白，适合 Revel 项目快速落地。它不处理模板渲染，只专注「构建 + 发送」，和 Revel 的 MVC 分离风格天然契合。
实操建议：
- 通过
go get gopkg.in/gomail.v2安装（注意 v2 分支，v1 已归档） - 不要在
app.Init()里初始化gomail.Dialer实例——它不是单例资源，每次发信前 new 一个更安全（避免连接复用导致超时或认证失效） - 务必显式调用
m.SetHeader("From", "...")，gomail不会从Send参数自动推导发件人 - 测试时优先用 Mailtrap 或 Ethereal（免费 SMTP 测试服务），避免触发真实邮箱的限频或拉黑
示例片段（放在 controller 方法内）：
d := gomail.NewDialer("smtp.ethereal.email", 587, "user@ethereal.email", "pass")
m := gomail.NewMessage()
m.SetHeader("From", "user@ethereal.email")
m.SetHeader("To", "test@example.com")
m.SetHeader("Subject", "Hello from Revel")
m.SetBody("text/plain", "This is the email body.")
if err := d.DialAndSend(m); err != nil {
app.Log.Error("email send failed", "err", err)
}
发送 HTML 邮件并嵌入模板变量
Revel 的 render.HTML 只负责 HTTP 响应，不能直接复用于邮件正文。你需要单独管理邮件模板路径（比如 app/views/email/welcome.html），再用 Go 标准库 html/template 渲染。
关键点：
- 模板文件不能放在
views/下被 Revel 自动编译——那套机制只服务 HTTP 请求，邮件模板要手动template.ParseFiles() - HTML 邮件必须同时提供
text/plain备用版本（部分客户端默认显示纯文本），否则可能被标记为垃圾邮件 - 内联样式比外部 CSS 更可靠（多数邮箱客户端会过滤
<style></style>或外部链接），避免用 Flex/Grid 布局 - 图片别用相对路径，全部转成 CID 内嵌或托管 CDN 链接（
<img src="https://cdn.example.com/logo.png" alt="Revel框架邮件发送功能的实现教程" >）
简短示意：
t, _ := template.ParseFiles("app/views/email/welcome.html")
var body bytes.Buffer
t.Execute(&body, map[string]interface{}{"Name": "Alice"})
m.SetBody("text/html", body.String())
m.AddAlternative("text/plain", "Hi Alice,\n\nWelcome to our service.") // 必须配对
生产环境必须处理的三个硬性问题
本地跑通 ≠ 生产可用。Revel 项目上线后，邮件失败往往静默发生，日志里只有空行或 timeout，排查成本极高。
容易踩的坑：
-
gomail.Dialer.Timeout默认是 0（无限等待），线上必须设为 10~15 秒，否则一次 SMTP 故障会让整个 HTTP 请求卡死 - 并发发信时没做连接池或限速，被 Mailgun/SendGrid 当成爬虫限流（返回 429 或直接断连）
- 没区分环境：开发用
useFileTransport = true（写到磁盘），生产才走网络；Revel 没这开关，得自己用revel.Config.BoolDefault("email.enabled", false)控制分支
最后提醒：Revel 的 AppInit 阶段不适合初始化邮件客户端。它发生在路由注册前，而很多 SMTP 配置（如密码）依赖 revel.Config.String("smtp.password")，后者在 AppInit 时尚未加载完成。真要全局复用，放到第一个 controller 的 Init() 里 lazy init 更稳妥。
