用 net/smtp 发送纯文本邮件最简路径是:配置正确 smtp 地址端口、使用应用专用密码、构造含 to/from/subject/mime-version 头的纯文本邮件体。

用 net/smtp 发送纯文本邮件最简路径
Go 标准库 net/smtp 足够发基础通知,无需第三方包。关键不是“能不能”,而是“怎么绕过常见认证失败”。Gmail、Outlook 等现代邮箱已禁用明文密码登录,必须用应用专用密码(App Password)或 OAuth2;国内企业邮箱则常要求开启 SMTP 服务并校验发信域名。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 先确认邮箱 SMTP 地址与端口:
smtp.gmail.com:587(STARTTLS)、smtp.qq.com:465(SSL)——端口错一个就dial tcp: i/o timeout - 用户名填完整邮箱地址(如
user@gmail.com),不是昵称或前缀 - 密码字段必须是应用专用密码,不是账户登录密码;QQ 邮箱需在「设置 → 账户 → POP3/IMAP/SMTP/Exchange」里生成
- 构造邮件正文时,必须包含
To、From、Subject和MIME-Version头,缺任一字段可能被拒收或进垃圾箱
发送 HTML 邮件时 Content-Type 必须手动设置
Go 没有内置 MIME 封装器,net/smtp 只管传输,不处理内容格式。直接把 HTML 字符串塞进 body 不会自动识别为网页邮件,收件方看到的是源码。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 手写 MIME 头:开头加
MIME-Version: 1.0和Content-Type: text/html; charset=utf-8 - HTML 内容本身要 UTF-8 编码,避免中文乱码;若含内联 CSS,确保样式简洁,多数邮箱客户端只支持有限 CSS 属性
- 不要依赖
<link rel="stylesheet">或远程 JS——会被拦截,内联样式也建议行内写(style="...") - 示例片段:
From: notify@example.com To: user@domain.com Subject: =?UTF-8?B?5byg5LiJ55Sf?= MIME-Version: 1.0 Content-Type: text/html; charset=utf-8 <p><h2>您好</h2><p>这是一封测试邮件</p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/ai/2405" title="大师兄智慧家政"><img src="https://img.php.cn/upload/ai_manual/001/246/273/176395441542705.png" alt="大师兄智慧家政" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a href="/ai/2405" title="大师兄智慧家政">大师兄智慧家政</a> <p>58到家打造的AI智能营销工具</p> </div> <a href="/ai/2405" title="大师兄智慧家政" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>
订阅管理不能只靠内存 map,必须持久化 + 去重校验
开发初期用 map[string]bool 存邮箱列表很顺手,但进程重启就丢数据,且无法跨实例同步。更麻烦的是,用户反复提交同一邮箱、大小写混用(User@Domain.com vs user@domain.com)、带空格或换行,都会导致重复发送或漏订阅。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 入库前统一做
strings.ToLower(strings.TrimSpace(email))归一化 - 数据库字段设为
UNIQUE约束,避免插入重复;PostgreSQL 可加LOWER(email)函数索引 - 退订链接必须带签名 token(如 HMAC-SHA256 + 时间戳),防止批量伪造退订请求;token 过期时间建议 ≤7 天
- 每次发信前查库确认状态字段(
is_subscribed = true),别信前端传来的“我还没退订”
并发发信时 smtp.Client 复用比新建更稳
每封邮件都 smtp.Dial 新建连接,容易触发邮箱服务商的频率限制(如 Gmail 每天 500 封、每分钟 10 封),还可能因 TCP 连接未及时关闭导致 too many open files。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 复用一个
*smtp.Client实例,调用c.Auth()登录一次即可,后续用c.Mail()+c.Rcpt()+c.Data()发多封 - 用
sync.Pool缓存bytes.Buffer或 MIME 构造器,减少 GC 压力 - 发信逻辑加简单限流:每秒最多 5 封(
time.Tick(200 * time.Millisecond)控制节奏),比硬扛错误再重试更可控 - 注意
Client不是 goroutine 安全的,高并发下需加锁或按批次分发
真正难的不是拼出一封能发出去的邮件,而是让每封都准时进收件箱、退订链路不可伪造、重试机制不放大故障。这些细节藏在 SMTP 协议响应码、邮箱服务商文档角落和线上日志里,而不是 API 文档首页。









