Go语言实现邮件发送功能_Golang通知系统实战

P粉602998670

发布时间：2026-01-22 08:27:11

355人浏览过

来源于php中文网

原创

常见原因是SMTP服务端拒绝未认证或未加密连接，需用PlainAuth显式认证、选587/465端口、QQ邮箱用授权码、Gmail用应用专用密码。

go语言实现邮件发送功能_golang通知系统实战

为什么 `net/smtp` 发不出邮件却没报错？

常见现象是调用 smtp.SendMail 返回 nil 错误，但收件人根本没收到——这通常不是代码问题，而是 SMTP 服务端拒绝了未认证或未加密的连接。Gmail、Outlook、QQ 邮箱等主流服务商默认禁用不带身份验证的明文 SMTP（端口 25），也拒绝未启用 TLS 的连接。

必须使用 auth := smtp.PlainAuth("", user, password, host) 显式传入认证凭据
优先选端口 587（STARTTLS）或 465（SMTPS），避免用 25
若用 QQ 邮箱，user 必须是完整邮箱地址（如 "xxx@qq.com"），密码需填「SMTP 授权码」而非登录密码
Gmail 要求开启「两步验证」并生成应用专用密码；否则会返回 535 5.7.8 Username and Password not accepted

如何构造带 HTML 内容和附件的 multipart 邮件？

Go 标准库没有开箱即用的 MIME 构建器，得手动拼装 multipart/mixed 和 multipart/alternative 结构。关键在于边界（boundary）一致、头部顺序正确、正文编码合规。

用 mime/multipart 创建 Writer，调用 w.WriteField("To", "...") 设置基础头字段
先写 multipart/alternative 子部分（含纯文本 text/plain 和 HTML text/html），再写附件部分
HTML 正文必须用 base64 编码，并声明 Content-Transfer-Encoding: base64
附件文件名含中文时，要用 mime.BEncoding.Encode("UTF-8", "简历.pdf") 编码，否则 Outlook 会显示乱码

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
writer.SetBoundary("myboundary123")

// HTML 部分
part, _ := writer.CreatePart(map[string][]string{
	"Content-Type": {"text/html; charset=UTF-8"},
	"Content-Transfer-Encoding": {"base64"},
})
base64.NewEncoder(base64.StdEncoding, part).Write([]byte(`你好`))

// 附件
part, _ = writer.CreatePart(map[string][]string{
	"Content-Type": {"application/pdf"},
	"Content-Disposition": {`attachment; filename*=UTF-8''%E7%AE%80%E5%8E%86.pdf`},
})
io.Copy(part, file)

writer.Close()

发送失败时怎么快速定位是网络、认证还是内容问题？

错误信息常被忽略，但 smtp.SendMail 返回的 error 值里包含原始 SMTP 状态码和服务器提示，是第一手线索。

情感家园企业站5.0 多语言多风格版

一套面向小企业用户的企业网站程序！功能简单，操作简单。实现了小企业网站的很多实用的功能，如文章新闻模块、图片展示、产品列表以及小型的下载功能，还同时增加了邮件订阅等相应模块。公告，友情链接等这些通用功能本程序也同样都集成了！同时本程序引入了模块功能，只要在系统默认模板上创建模块，可以在任何一个语言环境（或任意风格）的适当位置进行使用！

下载

捕获错误后，先检查是否为 *textproto.Error 类型：if e, ok := err.(*textproto.Error); ok { fmt.Println(e.Code, e.Msg) }
421 表示服务不可用（DNS 解析失败或目标主机拒连）；454 是 TLS 启动失败；535 是认证失败；554 多为内容被判定为垃圾邮件
本地测试可用 telnet smtp.qq.com 587 手动走一遍 EHLO → AUTH → MAIL FROM 流程，确认基础连通性
若日志中反复出现 550 Mail from ... not allowed，说明发信域名未配置 SPF 或 DKIM，需在 DNS 添加记录