Buffalo/mail 发送激活邮件需手动配置 smtp.Dialer、动态设置 From、使用 templates/mail/activation.html.plush 模板、校验邮箱格式、添加重试与降级机制，并确保 token 幂等性与时效性。
buffalo/mail 包是 Buffalo 官方推荐的邮件发送方案，它不内置 SMTP 配置，但提供了可插拔的 mail.Sender 接口和开箱即用的 mail.SMTPSender 实现。发送注册激活邮件的关键不是“能不能发”，而是「怎么配、怎么传参、怎么避免被当垃圾邮件」。
SMTPSender 初始化必须显式传入 *smtp.Dialer，不能只靠环境变量
很多人以为填好 BUFFALO_SMTP_HOST 等环境变量就能自动生效，实际不行。mail.NewSMTPSender 不读环境变量，它只接受一个 *smtp.Dialer 实例。你得自己构造并配置 TLS/SSL 行为：
-
smtp.PlainAuth仅适用于 STARTTLS 场景，Gmail 或 Outlook 用这个； - 若 SMTP 服务要求 SSL（端口 465），必须用
smtp.Dialer{SSL: true}，否则连接直接超时； - 使用 Gmail 时，
Username必须是完整邮箱（如user@gmail.com），且需开启「App Password」而非账户密码； - 别把
From字段硬编码在 sender 里——它应该随每封邮件动态设置，否则激活链接里的 token 无法绑定到具体用户。
激活邮件模板必须用 r.HTML 渲染，且路径要对
Buffalo 的 mail.TemplateMailer 依赖 app.Templates 查找 HTML 模板。如果你已禁用模板系统（比如做了纯 API 项目），mail.NewTemplateMailer 会 panic。常见错误现象：template: "activation.html" is undefined。
- 模板路径必须是
templates/mail/activation.html.plush（注意mail/子目录）； - Plush 模板里不能用
c.Param()，要用data.Token这类传入的字段； - 激活链接必须带完整域名（
https://example.com/activate?token=xxx），不能用相对路径，否则邮件客户端打不开； - 别在模板里调
r.JSON或c.Render—— 邮件模板渲染阶段不经过 Buffalo 的 context 生命周期。
发送前必须校验 Message.To 和 Message.From 格式
mail.Message 对字段格式很敏感。一个常见错误是传入空字符串或未初始化的 slice 给 To，导致 Send 返回 invalid address "" 而不是明确报错。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
To必须是[]string，哪怕只有一个收件人也要写成[]string{u.Email}； -
From必须是合法邮箱格式（含 @ 符号），且建议与 SMTP 认证用户名一致，否则某些服务商（如 Mailgun）会拒绝投递； - 附件路径如果用相对路径（如
./logo.png），运行时会因工作目录不确定而失败，应改用filepath.Join(app.Root, "public", "img", "logo.png")； - 激活邮件务必设
Message.Headers["X-Template"] = "activation"，方便后续在日志或监控中区分类型。
生产环境必须加重试和失败降级逻辑
SMTPSender.Send 是同步阻塞调用，网络抖动或认证失败会导致整个注册流程卡住。Buffalo 不提供自动重试，你得自己 wrap。
- 不要在
UsersResource.Create里直接调sender.Send()，应丢进 goroutine 并 recover panic； - 建议用
backoff.Retry尝试最多 2 次，间隔 1s，失败后写入数据库失败记录表（含user_id,attempt_at,error）； - 若 SMTP 完全不可用，降级为写本地文件（
log.Printf("[email-fallback] activation mail for %s saved to /tmp/...")），人工补发； - 别忘了在事务里处理：先
INSERT users，再发邮件，失败不回滚用户记录（否则重试时会违反唯一约束）。
真正容易被忽略的是时间窗口和幂等性：激活链接通常带 24 小时过期 token，但邮件可能延迟数小时才送达；用户重复注册时，旧 token 应该自动失效，这需要在生成新 token 前先清掉该邮箱所有未使用的 token 记录。
