GolangSMTP邮件配置教程详解
想知道如何用 Golang 发送邮件吗?本文为你提供一份详细的 Golang SMTP 发送邮件配置教程,基于 `net/smtp` 包,教你轻松实现邮件发送功能。从配置 SMTP 服务器信息、解决认证问题(如 `smtp.PlainAuth` 的使用),到发送 HTML 格式邮件,再到利用 `mime/multipart` 包发送带附件的邮件,本文都将一一讲解。同时,还包括错误处理技巧,例如如何判断和处理连接超时、认证失败等常见异常。掌握这些技巧,让你的 Golang 应用也能具备强大的邮件发送能力!
答案:使用net/smtp包配置SMTP服务器信息并构造邮件内容,通过smtp.PlainAuth实现认证,设置邮件头的Content-Type为text/html发送HTML邮件,利用mime/multipart包构建正文和附件的多部分消息以发送带附件邮件,同时通过错误类型判断处理连接超时、认证失败等异常。

Golang发送邮件,核心在于net/smtp包的使用。配置好SMTP服务器信息,就能轻松发送邮件了。
解决方案
首先,需要配置SMTP服务器的连接信息,包括服务器地址、端口、用户名和密码。然后,构造邮件内容,包括发件人、收件人、主题和正文。最后,使用smtp.SendMail函数发送邮件。
如何处理SMTP服务器的认证问题?
SMTP服务器认证是发送邮件的关键一步。很多服务器都需要验证你的身份,防止垃圾邮件。smtp.SendMail函数需要一个smtp.Auth接口的实现。smtp包提供了几种认证方式,最常用的是smtp.PlainAuth。
例如:
package main
import (
"fmt"
"net/smtp"
"log"
)
func main() {
// SMTP服务器配置
smtpServer := "smtp.example.com"
smtpPort := 587
smtpUser := "your_email@example.com"
smtpPass := "your_password"
from := "your_email@example.com"
to := []string{"recipient@example.com"}
subject := "Golang SMTP Email"
body := "This is a test email from Golang using the smtp package."
// 构造邮件内容
message := []byte("To: recipient@example.com\r\n" +
"Subject: " + subject + "\r\n" +
"\r\n" + body + "\r\n")
// 认证信息
auth := smtp.PlainAuth("", smtpUser, smtpPass, smtpServer)
// 连接SMTP服务器并发送邮件
err := smtp.SendMail(fmt.Sprintf("%s:%d", smtpServer, smtpPort), auth, from, to, message)
if err != nil {
log.Fatal(err)
}
fmt.Println("Email sent successfully!")
}这段代码展示了如何使用smtp.PlainAuth进行认证。需要注意的是,实际应用中,用户名和密码应该从安全的地方读取,例如环境变量或配置文件,而不是硬编码在代码中。
如果你的SMTP服务器使用其他认证方式,例如CRAM-MD5或LOGIN,你需要使用相应的smtp.Auth接口实现。
如何发送HTML格式的邮件?
发送HTML邮件需要在邮件头中指定Content-Type。
修改上面的例子:
package main
import (
"fmt"
"net/smtp"
"log"
)
func main() {
// SMTP服务器配置
smtpServer := "smtp.example.com"
smtpPort := 587
smtpUser := "your_email@example.com"
smtpPass := "your_password"
from := "your_email@example.com"
to := []string{"recipient@example.com"}
subject := "Golang SMTP HTML Email"
body := `
HTML Email
This is an HTML email from Golang!
Using the smtp package.
`
// 构造邮件内容
message := []byte("To: recipient@example.com\r\n" +
"Subject: " + subject + "\r\n" +
"MIME-version: 1.0\r\n" +
"Content-Type: text/html; charset=\"UTF-8\"\r\n" +
"\r\n" + body + "\r\n")
// 认证信息
auth := smtp.PlainAuth("", smtpUser, smtpPass, smtpServer)
// 连接SMTP服务器并发送邮件
err := smtp.SendMail(fmt.Sprintf("%s:%d", smtpServer, smtpPort), auth, from, to, message)
if err != nil {
log.Fatal(err)
}
fmt.Println("Email sent successfully!")
}注意Content-Type: text/html; charset="UTF-8"这行,它告诉邮件客户端这是一个HTML邮件,并且使用UTF-8编码。
如何发送带有附件的邮件?
发送带附件的邮件稍微复杂一些,需要使用mime/multipart包来构造邮件内容。简单来说,你需要将邮件正文和附件分别作为multipart.Part添加到multipart.Writer中,并设置正确的Content-Type和Content-Disposition。
这部分代码比较长,这里只给出思路:
- 创建
multipart.Writer。 - 添加邮件正文部分,设置
Content-Type: text/plain; charset="UTF-8"或Content-Type: text/html; charset="UTF-8"。 - 添加附件部分,设置
Content-Type为附件的MIME类型,例如application/pdf,设置Content-Disposition: attachment; filename="your_file.pdf"。 - 将
multipart.Writer的内容写入到bytes.Buffer中。 - 设置邮件头的
Content-Type为multipart/mixed; boundary="your_boundary",其中your_boundary是multipart.Writer的边界字符串。 - 使用
smtp.SendMail发送邮件。
实际操作中,可以使用现成的库,例如github.com/jordan-wright/email,它简化了发送带附件邮件的过程。
如何处理发送邮件时遇到的错误?
发送邮件时可能会遇到各种错误,例如连接超时、认证失败、服务器拒绝等。需要仔细处理这些错误,并提供有用的错误信息。
例如,可以检查smtp.SendMail返回的错误类型:
err := smtp.SendMail(fmt.Sprintf("%s:%d", smtpServer, smtpPort), auth, from, to, message)
if err != nil {
if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
log.Println("Timeout error:", err)
} else {
log.Println("SendMail error:", err)
}
// 可以根据错误类型进行不同的处理
}此外,还可以使用log包记录错误信息,方便排查问题。在生产环境中,应该对发送邮件的操作进行监控,及时发现并解决问题。
以上就是《GolangSMTP邮件配置教程详解》的详细内容,更多关于邮件发送,net/smtp,GolangSMTP,smtp.PlainAuth,附件邮件的资料请关注golang学习网公众号!
Java高并发Map:ConcurrentHashMap使用详解
- 上一篇
- Java高并发Map:ConcurrentHashMap使用详解
- 下一篇
- 享界汽车11月交付超6000,12月目标破万
-
- Golang · Go教程 | 21分钟前 | Mutex · go · pprof · 性能排查 · pprof Go mutex profile Go锁竞争
- Go 服务锁竞争变慢怎么查:mutex profile 的采样、定位和修复手册
- 395浏览 收藏
-
- Golang · Go教程 | 55分钟前 | go · go.work · CI · Go Modules · Go go.work Go多模块 Go CI
- Go 多模块仓库怎么用 go.work:本地联调、依赖同步和 CI 一致性工作流
- 380浏览 收藏
-
- Golang · Go教程 | 5小时前 | golang · 性能优化 · Go 1.26 · 垃圾回收 Go 1.26 Green Tea GC
- Go 1.26 Green Tea GC 默认开启:升级后该看哪些指标,怎么做回退验证
- 334浏览 收藏
-
- Golang · Go教程 | 2天前 | 并发 · HTTP · 性能优化 · 故障排查 · Go教程 · Go Goroutine 连接复用 pprof http.Client close Response.Body
- Go HTTP 响应体忘记关闭:连接占用与 Goroutine 增长的排查修复
- 201浏览 收藏
-
- Golang · Go教程 | 6天前 | 单元测试 · 错误处理 · Go教程 · errors.Join · errors.Is · errors.Is Go错误处理 Go教程 errors.Join 多错误返回 批量校验
- Go errors.Join 怎么用:多错误返回、errors.Is 判断和 nil 兼容
- 352浏览 收藏
-
- Golang · Go教程 | 6天前 | Context · 超时控制 · Go教程 · http.Client · Transport · Go context 请求超时 Transport http.Client Client.Timeout ResponseHeaderTimeout
- Go HTTP 客户端超时怎么设:Client.Timeout、context 和 Transport 分层预算
- 218浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- ljg-skills
- ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
- 4506次使用
-
- MELO音乐
- MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
- 4184次使用
-
- UniScribe
- UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
- 4150次使用
-
- 剧云
- 剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
- 4375次使用
-
- 万象有声
- 万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
- 4320次使用
-
- Java 性能优化上线清单:从定位、改造到灰度发布
- 2026-06-11 860浏览
-
- Spring Boot 压测验证:Gatling、JMeter 与性能回归门禁
- 2026-06-11 843浏览
-
- Java NMT 非堆内存排查:Direct Buffer、线程栈与 Metaspace 分析
- 2026-06-11 826浏览
-
- Spring Boot 容器内存优化:JVM 堆、非堆与 MaxRAMPercentage
- 2026-06-11 809浏览
-
- Tomcat 连接与线程参数调优:maxThreads、acceptCount 与 KeepAlive
- 2026-06-11 792浏览

