Revel框架需手动集成SMTP，最稳妥方式是用Go原生net/smtp或github.com/jordan-wright/email库；必须通过环境变量安全配置参数，注意TLS证书校验、MIME头编码、云服务器端口限制等隐性规则，否则本地能发、线上必失败。
Revel 框架本身不内置邮件发送能力，必须自行集成 SMTP 客户端库；直接调用 net/smtp 或封装 github.com/jordan-wright/email 是最稳妥的做法，硬套 Spring Boot 那套配置方式会失败。
Revel 中怎么调用 Go 原生 smtp 发送纯文本邮件
Revel 是 Go Web 框架，所有逻辑都写在 app/controllers 或独立工具包里，不能依赖 Spring Boot 的 JavaMailSender 自动配置。最轻量的方式是用标准库 net/smtp 手动构造 AUTH 和 TLS 连接：
-
smtp.PlainAuth第一个参数为空字符串（identity），不是用户名 - 若 SMTP 服务要求 SSL（如 163 邮箱的 465 端口），必须用
crypto/tls包显式 Dial，不能直接传host:port给smtp.SendMail - 邮件正文需手动拼接 MIME 头，
Content-Type: text/plain; charset=utf-8必须带上，否则中文变乱码 - 示例片段：
auth := smtp.PlainAuth("", "user@163.com", "your-app-password", "smtp.163.com")
msg := []byte("To: target@example.com\r\n" +
"From: user@163.com\r\n" +
"Subject: Hello\r\n" +
"Content-Type: text/plain; charset=utf-8\r\n\r\n" +
"你好，这是一封测试邮件。")
err := smtp.SendMail("smtp.163.com:465", auth, "user@163.com", []string{"target@example.com"}, msg)
用 github.com/jordan-wright/email 封装 HTML 邮件更可靠
原生 net/smtp 写 HTML 邮件容易漏 MIME boundary、编码错误或附件头缺失，github.com/jordan-wright/email 能自动处理这些细节，且 Revel 项目可直接 go get 引入：
-
e.From若含昵称，格式必须为"昵称 <user>"</user>，少空格或尖括号都会被 SMTP 拒绝 - 163/qq 邮箱强制要求发信域名与
From地址后缀一致，From: admin@example.com却走smtp.163.com会被拦截 - 调用
e.SendWithTLS时，&tls.Config{ServerName: "smtp.163.com"}的ServerName必须和 host 一致，否则证书校验失败 - 示例关键行：
e := email.NewEmail()
e.From = "运维组 <user@163.com>"
e.To = []string{"admin@example.com"}
e.Subject = "告警：CPU 使用率超阈值"
e.HTML = []byte("<h2>⚠️ 高负载提醒</h2><p>当前 CPU 使用率达 92%</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2853" title="Revel框架 0.19.0"><img
src="https://img.php.cn/upload/manual/001/589/237/6ad0beeae1170134.png" alt="Revel框架 0.19.0" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2853" title="Revel框架 0.19.0">Revel框架 0.19.0</a>
<p>Revel框架 0.19.0 版本源码包下载，适合关注 Referrer-Policy、vendor 识别、Gorp 事务抽象和 CSRF 修复的开发团队。</p>
</div>
<a href="/xiazai/gongju/2853" title="Revel框架 0.19.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>")
err := e.SendWithTLS("smtp.163.com:465", auth, &tls.Config{ServerName: "smtp.163.com"})
Revel 配置文件怎么存 SMTP 参数才安全
别把密码硬编码进 controller，也别放 conf/app.conf 明文写 email.password=xxx —— Revel 的 app.conf 不做加密，部署时极易泄露。正确做法是：
- 在
conf/app.conf中只存占位符，例如email.host=${EMAIL_HOST:smtp.163.com} - 启动时通过环境变量注入真实值：
EMAIL_HOST=smtp.qq.com EMAIL_PORT=587 EMAIL_USER=bot@qq.com EMAIL_PASS=xxxxxx revel run -a myapp - Revel 启动时自动读取
os.Getenv，无需额外解析逻辑 - 敏感字段如
EMAIL_PASS绝对不要记录在 Git 历史中，CI/CD 流水线里应设为 secret 变量
为什么本地开发能发、上线就 timeout
常见原因不是代码问题，而是网络策略限制：
- 云服务器（如阿里云、腾讯云）默认屏蔽 25/465/587 等 SMTP 端口出向流量，需工单申请解封或改用 API 邮件服务（如 SendGrid、Mailgun）
- Docker 容器内 DNS 解析失败导致
smtp.qq.com无法 resolve，可在docker run加--dns 8.8.8.8临时验证 - 部分 SMTP 服务商（如 163）对单 IP 每小时发信数限流，测试时高频触发会被临时拉黑，错误信息通常是
554 DT:SPM - Revel 日志级别设太低（如
WARN），SMTP 底层net.Error被吞掉，务必在send()函数里加revel.ERROR.Printf("SMTP send failed: %v", err)
真正卡住的地方往往不在代码怎么写，而在 SMTP 服务商的隐性规则、云厂商的端口策略、以及环境变量加载时机 —— 这三者没对齐，再漂亮的封装也发不出一封成功邮件。
